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第 1 章 Linux 设备 驱动 程序 人 门 


到 目前 为 止 ， 设备 驱动 程序 代码 仍 然 是 Linux 内 核 代 码 中 最 多 的 部 分 。 操 作 系统 最 重要 
的 功能 之 一 就 是 支持 各 类 设备 的 访问 ， 承 担 硬 件 与 应 用 软件 之 间 的 桥梁 作用 。Linux 操作 系 
统 中 主要 包含 字符 设备 、 块 设备 、 网 络 设备 等 三 类 基本 的 设备 驱动 程序 ， 内 核 中 的 设备 驱动 
程序 大 部 分 基于 这 三 类 设备 驱动 。 本 章 主要 介绍 Linux 设备 驱动 程序 的 入 门 知识 ， 包 含 模 块 
基础 、 字 符 设备 驱动 、proc 文件 系统 等 内 容 。 


1.1 设备 驱动 程序 基础 


1.1.40. 驱动 程序 的 概念 


所 谓 设备 驱动 程序 ， 就 是 驱使 设备 按照 用 户 的 预期 进行 工作 的 软件 ， 它 是 应 用 程序 与 设 
备 沟 通 的 桥梁 。 从 本 质 上 讲 ， 设 备 驱 动 程序 主要 负责 硬件 设备 的 参数 配置 、 数 据 读 写 与 中 断 
处 理 。Linux 的 运行 空间 分 为 内 核 空间 与 用 户 空 间 。 为 了 保护 系统 的 安全 ， 这 两 个 空间 各 自 
运行 在 不 同 的 级 别 ， 不 能 相互 直接 访问 和 共享 数据 。Linux 内 核 为 应 用 层 提 供 了 一 系列 系统 
调用 接口 ， 应 用 程序 可 以 通过 这 组 接口 来 获得 操作 系统 内 核 提 供 的 服务 。 应 用 层 程 序 运行 在 
] 户 态 ， 而 设备 驱动 程序 是 操作 系统 的 一 部 分 ， 运 行 在 内 核 态 。 应 用 程序 要 控制 硬件 设备 ， 
首先 通过 系统 调用 访问 内 核 ， 内 核 层 根 据 系 统 调用 号 来 调用 驱动 程序 对 应 的 接口 函数 来 访问 
设备 。 图 1-1 说 明了 Linux 驱动 程序 的 运行 原理 。 


应 用 程序 
户 态 
统 调 


驱动 程序 


接口 控制 器 
总 线 
设备 /外 围 芯片 
图 1-1 设备 驱动 程序 的 原理 


Linux 中 的 大 部 分 驱动 程序 是 以 内 核 模块 的 形式 编写 的 。 内 核 模 块 是 Linux 内 核 向 外 部 
提供 的 一 个 接口 ， 其 全 称 为 动态 可 加 载 内 核 模 块 (Loadable Kernel Module, LKM)。Linux 
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内 核 本 身 是 一 个 单 内 核 Cnonolithic kernel)， 具 有 效率 高 的 优点 ， 也 具有 可 扩展 性 和 可 维护 
性 差 的 缺陷 。 模 块 机 制 就 是 为 了 弥补 这 一 缺陷 而 生 。 内 核 模 块 可 以 被 单独 编译 ， 它 在 运行 时 
被 链接 到 内 核 作为 内 核 的 一 部 分 在 内 核 空 间 运 行 。 要 让 内 核 支 持 可 加 载 模块 ， 需 要 配置 内 核 
的 【Enable loadable module support】 选 项 ， 如 图 1-2 所 示 。 


General setup 一 -一 > 
[F] Enable loadable module support---^ 
—k- Enable the block layer -———^ 
System Type ——-5 
Bus support 一 -一 > 
Kernel Features 一 -一 > 
Boot options 一 -一 > 
CPU Power Management 一 -一 > 
Floating point emulation 一 一 一 人 
Userspace binary formats 一 一 一 人 
Power management options -—--? 
[F] Networking support 一 -一 > 
evice Drivers 一 -一 > 
Firmware Drivers 一 
File systems 一 -一 > 
Kernel hacking 一 -一 > 
Security options 一 -一 > 


图 1-2 在 内 核 中 增加 可 加 载 模块 支持 


1.1.2 ”驱动 程序 的 加 载 方式 
Linux 设备 驱动 程序 有 两 种 加 载 方式 。 一 种 是 直接 编译 进 Linux 内 核 ， 在 Linux 启动 时 
加 载 ， 另 一 种 是 采用 内 核 模 块 方式 ， 这 种 模块 可 动态 加 载 与 卸载 。 
如 果 和 希望 将 新 驱动 程序 编译 进 内 核 ， 需 要 修改 内 核 代码 和 编译 选项 。 下 面 以 字符 型 设备 
为 例 ， 说 明 如 何在 Linux 内 核 中 添加 一 个 新 的 设备 驱动 程序 。 如 果 驱 动 程序 代码 源 文件 为 
infrared_s3c2410.c， 将 infrared s3c2410.c 复制 到 内 核 代码 的 /drivers/char 目录 ， 并 在 该 目录 下 
的 Kconfig 文件 最 后 增加 如 下 语句 : 


config INFRARED REMOTE 
tristate "INFRARED Driver for REMOTE" 
depends on ARCH S3C64XX | ARCH. S3C2410 
default y 
help 


在 该 目录 下 的 Makefile 中 添加 如 下 语句 : 


Obj-$(CONFIG INFRARED REMOTE)+= infrared s3c2410.0 


进入 Linux 内 核 源 代码 目录 ， 执 行 make menuconfig 命令 后 ， 选 择 【device drivers] -> 
[character devices], AWK] 1-3 所 示 的 内 核 配 置 窗口 ， 可 见 最 后 一 行 即 新 增 的 驱动 ; 


X > GSM MUX line discipline support (EXPERIMENTAL) 
< 2 Trace data sink for MIPI P1143.7 eJIAG standard 
[*] /dev/mem virtual device support 
[*] fdev/kmem virtual device support 
Serial drivers 一 一 一 
[ ] AEM JTAG DCC console 
< > IPMI top-level message handler ---- 
Sk? Hardware Random Humber Generator Core support 一 -一 六 


2 Siemens R3964 line discipline 

> EAW driver (dev/raw/raN) 

> TEM Hardware Support ---- 

> Xillybus generic FPGA interface 
> INFRARED Driver for REMOTE (EW) 


Ee 


图 1-3 在 内 核 中 增加 新 驱动 程序 
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在 内 核 配 置 窗口 中 可 以 使 用 上 下 键 、 空 格 键 和 回 车 键 进 行 选 择 、 移 动 和 取消 选择 。 内 核 
配置 窗口 中 以 < > 带头 的 行 是 内 核 模块 的 配置 ， 以 [ ] 带 头 的 行 是 内 核 功能 的 配置 。 选 项 前 如 
果 为 <*>， 表 示 相 应 的 模块 将 被 编译 进 内 核 。 如 果 选 项 前 是 < > 则 表示 不 编译 进 内 核 。 这 里 在 
[INFRARED Driver for REMOTE] 行 前 面 设置 为 <*>， 则 infrared s3c2410.0 将 被 编译 进 内 
核 。 在 使 用 make zImage 命令 编译 内 核 时 所 有 设置 为 <*> 的 项 将 被 包含 在 内 核 映像 中 。 

采用 可 加 载 模块 方式 让 驱动 程序 的 运行 更 加 灵活 ， 也 更 利于 调试 。 可 加 载 模块 用 于 扩展 
Linux 操作 系统 的 功能 。 使 用 内 核 模 块 的 优点 是 可 以 按照 需要 进行 加 载 ， 而 且 不 需要 重新 编 
译 内 核 。 这 种 方式 控制 了 内 核 的 大 小 ， 而 模块 一 旦 被 插入 内 核 ， 它 就 和 内 核 其 他 部 分 一 样 ， 
可 以 访问 内 核 的 地 址 空间 、 函 数 和 数据 。 可 加 载 模 块 通常 以 .ko 为 扩展 名 。 在 图 1-3 中 选项 
前 如 果 为 <M>， 表 示 编 译 成 可 加 载 模块 。 在 使 用 make modules 命令 编译 内 核 时 ， 所 有 设置 
为 <M> 的 项 将 被 编译 。make modules 结束 后 可 以 使 用 下 面 的 命令 安装 内 核 中 的 可 加 载 模块 文 
件 到 一 个 指定 的 目录 : 


make modules install INSTALL MOD PATH=/home/usr/modules 
使 用 make 命令 编译 内 核 相 当 于 执行 make zImage 和 make modules 两 个 命令 。 


1..3 ”编写 可 加 载 模块 
Linux 内 核 模 块 必须 包含 以 下 两 个 接 
module init(your init func); /模块 初始 化 接口 
module exit(your exit func); RISER A 
加 载 一 个 内 核 模 块 的 命令 是 insmod， 格 式 如 下 : 
#insmod modulename.ko 
印 载 一 个 内 核 模块 的 命令 是 rnmod， 格 式 如 下 : 
#rmmod modulename 
可 加 载 模块 的 源 代 码 可 以 放 在 内 核 代 码 树 中 ， 也 可 以 独立 于 内 核 代码 树 。 如 果 是 后 一 种 
情况 ， 需 要 为 可 加 载 模块 编写 makefile 文件 。 可 加 载 模块 的 makefile 文件 最 重要 的 就 是 设置 
如 下 几 个 变量 ; 


CC= arm-none-linux-gnueabi-gcc 


obj-m:= smodule.o 
KERNELDIR ?= /root/fgj/linux-4.5.2 


CC 是 编译 器 ，obj-m 为 需要 编译 的 目标 模块 ，KERNELDIR 为 内 核 路 径 。 注 意 在 编写 可 
加 载 模块 前 先 要 有 一 个 内 核 代 码 目录 树 。KERNELDIR 的 内 核 版 本 必须 与 运行 的 内 核 版 本 一 
致 ， 否 则 编译 出 的 模块 往往 无 法 加 载 。 

例 1.1 最 简单 的 内 核 模块 

代码 见 \samples\1doorn\1-1simple。 核 心 代码 如 下 : 


static int demo module init(void) 
{ 
printk("demo module init\n"); 
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return 0; 
} 
static void demo module exit(void) 
{ 

printk("demo module exit\n"); 


j 
/模块 入 口 


module init(demo module init); 


module exit(demo module exit); 
MODULE DESCRIPTION('simple module"); 
MODULE LICENSE("GPL"); 


模块 运行 在 内 核 态 ， 不 能 使 用 用 户 态 C 库 函 数 中 的 printf 函数 ， 而 要 使 用 printk 函数 打 
印 调试 信息 。 编 写 一 个 Makefile 文件 如 下 : 


AR = ar 
ARCH = arm 
CC = arm-none-linux-gnueabi-gcc 
DEBFLAGS = -02 
obj-m := smodule.o 
KERNELDIR ?- /root/fgj/linux-4.5.2 
PWD := $(shell pwd) 
modules: 
$(MAKE) -C $(KERNELDIR) M=$(PWD) LDDINC-$(PWD).../include modules 
clean: 


rm -rf *.o *— core .depend .*.cmd *.ko *.mod.c .tmp versions 
执行 make 后 生成 smodule.ko。 运 行 结果 如 下 : 


[root@urbetter drivers] insmod smodule.ko 

demo module init 

[root@urbetter drivers |? cat /proc/modules 

smodule 868 0 - Live 0xbf000000 (O) 

[root(Q)urbetter drivers | rmmod smodule 

rmmod: can't change directory to "/lib/modules': No such file or directory 
[root(Qurbetter /home [mkdir -p /lib/modules/uname -r' 

[root(Q)urbetter drivers | rmmod smodule 


demo module exit 


第 一 次 运行 rmmod smodule 会 失败 ， 因 为 需要 在 /lib/modules 目录 下 建立 以 内 核 版 本 号 
为 名 称 的 目录 ， 才 能 正确 和 印 载 模块 。uname -了 用 来 得 到 内 核 版 本 号 。 建 立正 确 的 目录 后 ， 模 
En] EAE TE RE SR o 


1.1.4” 带 参数 的 可 加 载 模 块 


宏 MODULE PARM(vartypexrighb 用 于 向 模块 传递 命令 行 参数 。 参 数 类 型 可 以 是 整 
数 、 长 整 型 、 字 符 串 等 类 型 。 
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例 1.2 带 参数 的 内 核 模块 实例 


© 
TH 
di 
E 
71 
B 
"3 
3 
a 
o 
o 
"5 
NS 
z 
[em 
e 
3 
T 
x 
x 
pu 
Jl 
一 
md 
I 
J 
Gy 
S 
Æ 
人 
车 
i 
= 
yk 
[js 
a 
Ri 
E 
W 


等 参数 。 核 心 代码 如 下 : 


static int itype-0; 


module param(itype, int, 0); 
static int btype — 0; 
module param(btype, bool, 0); 


static unsigned char ctype-0; 


module param(ctype, byte, 0); 


static char *stype—-0; 


module param(stype, charp, 0); 


static int init demo module init(void) 


printk("simple module init\n"); 
printk("itype-96dW" itype); 
printk("btype=%d\n",btype); 
printk("ctype=%d\n",ctype); 
printk("stype='%s'\n",stype); 


static void _ exit demo module exit(void) 


printk("simple module exit\n"); 


/模块 初始 化 
return 0; 

j 

RRR EZR 

{ 

} 


module init(demo module init); 


module exit(demo module exit); 


接 下 来 编写 一 个 Makefile 文件 ， 同 例 1.1。 执 行 make 后 生成 smodule.ko。 运 行 结 


[root@urbetter /homel#insmod smodule.ko itype=2 btype-1 ctype=0xAC stype-'a' 


simple module init 


itype=2 
btype=1 
ctype=172 


c3 


stype=a 


1..5 模块 依赖 


Rl F: 


Linux 内 核 模块 之 间 可 以 相互 引用 一 些 符号 ， 这 些 符号 包括 函数 与 变量 。 符 号 必须 导出 


才能 被 引用 。 内 核 使 


的 符号 ， 称 为 模块 依赖 关系 。 被 引用 的 模块 必须 先 安装 ， 引 用 模块 才能 安装 。 


日 其 他 模块 


] 宏 定义 EXPORT SYMBOL 导出 变量 与 函数 。 一 个 模块 引 月 


例 1.3 内 核 模块 依赖 实例 
代码 见 \samples\1door\1-10export。 本 实例 演示 了 内 核 的 符号 导出 以 及 模块 依赖 。 核 心 代 


码 如 下 所 示 : 


//smodule dep.c 


int function of dep(void) 


1 


j 


EXPORT SYMBOL(function of dep); — //5 


//smo 


printk("function of dep"); 
return 0; 


E 
Bi 
Yee 


dule.c 


extern int function of dep(void); 


static 


1 


} 
很 显然 ， 


GE = 


int init demo module init(void) 


printk("simple module init\n"); 
function of dep); /引用 函数 
return 0; 


smodule 模块 依赖 smodule dep 函数 。 接 下 来 编写 一 个 Makefile: 


arm-none-linux-gnueabi-gcc 


DEBFLAGS = -02 
obj-m := smodule.o smodule dep.o 
KERNELDIR ?= /root/fgj/linux-4.5.2 


PWD 


:= $(shell pwd) 


modules: 


$(MAKE) -C $(KERNELDIR) M=$(PWD) LDDINC=$(PWD)../include modules 


clean: 


rm -rf *.o *— core .depend .*.cmd *.ko *.mod.c .tmp versions 


执行 make 后 生成 smodule.ko Ej smodule dep.ko。 运 行 结果 如 下 : 
[root@urbetter drivers]|£ modinfo smodule.ko 
filename: smodule.ko 
license: GPL 
author: fgjnew «fgjnew(2)163.com- 
description: simple module 
depends: smodule dep 
vermagic: 4.5.2 mod unload ARMv6 p2v8 


[root(a)urbetter drivers | insmod smodule.ko 


smodule: Unknown symbol function of dep (err 0) 


insmod: can't insert 'smodule.ko': unknown symbol in module or invalid parameter 


[root(g)urbetter drivers |? insmod smodule dep.ko 


simple module dep init 


[root(a)urbetter drivers | insmod smodule.ko 


simple module init 


function of dep 
[root(a)urbetter drivers |? 


可 见 必 须 


| 


先 安装 smodule dep.ko 才能 安装 smodule.ko. 


1.1.6 printk 的 等 级 
内 核 态 的 打印 函数 printk 可 以 设 定 打印 信息 的 等 级 。printk 的 打印 等 级 设置 如 下 : 


int console printk[4] = { 


CONSOLE LOGLEVEL DEFAULT, 
MESSAGE LOGLEVEL DEFAULT, 


CONSOLE LOGLEVEL MIN, 


CONSOLE LOGLEVEL DEFAULT, 


ls 


#define console loglevel (console printk[0]) 


E 


$13 


ZAE 
默认 消息 日 
最 小 的 控制 台 日 


— 
* 


E 
* 


m 


— 
* 


默认 控制 合 日 


#define default message loglevel (console printk[1]) 


#define minimum console loglevel (console printk[2]) 


#define default console loglevel (console printk[3 ]) 


其 中 console loglevel 是 当 


前 控制 台 日 


志 级 别 ， 优 先 级 比 它 高 的 信息 将 打印 到 控制 台 。 
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台 日 志 级 别 */ 
志 级 别 */ 


志 级 别 */ 


志 级 别 */ 


default message loglevel 为 默认 消息 日 志 级 别 。minimum console loglevel 为 最 低 的 可 设置 的 控 


H 


制 台 


#define KERN EMERG 
#define KERN ALERT 
#define KERN CRIT 
#define KERN ERR 
#define KERN WARNING 
#define KERN NOTICE 
#define KERN INFO 
#define KERN_DEBUG 


下 面 是 


uH 


135209]. default console loglevel XH 


& H2]. printk 的 打印 等 级 包括 : 


hs) e 


认 的 控制 
KERN SOH "0" PES 系统 不 可 
KERN SOH "1" P*. 必须 立即 响应 */ 
KERN SOH "2" f* yug 
KERN SOH "3" PF—RESER */ 

KERN SOH "4" f* En) 
KERN SOH "5" PF 普通 ， 但 需要 注意 六 
KERN SOH "6" [* 提示 */ 
KERN SOH "7" 证 调试 信息 */ 


[root@urbetter kernel]# pwd 


/proc/sys/kernel 


[root@urbetter kernel]? cat printk 


了 4 1 


这 四 个 值 分 别 对 应 于 console printk 数组 的 0—3 字 节 。 调 整 printk 打印 等 级 的 方法 


如 下 : 


7 


[root@urbetter kernel]# echo 6 4 
[root@urbetter kernel]? cat printk 


6 4 1 


7 


个 带 等 级 控制 的 printk 函数 的 用 法 示例 : 
printk(KERN INFO "kernel print %d\n",value); 


对 于 未 指定 打印 等 级 的 消息 ， 根 据 default_ message loglevel Æ f 
default message loglevel 的 优先 级 高 于 console loglevel 则 打印 ， 和 否则 不 打印 
可 以 通过 /proc/sys/kernel/printk 文件 动态 调整 printk 的 打印 等 级 : 


i 


Tj 


定 是 否 打 印 。 


D 


o 


us 


1 7 > /proc/sys/kernel/printk 
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1.1.7 设备 驱动 程序 类 别 
， 设 备 驱动 程序 为 各 种 设备 提供 了 一 致 的 访问 接口 ， 用 户 程序 可 以 像 


xh 


洛 通 文件 一 相 


fr Linux 操作 系统 ! 


(1) 字符 设备 


Linux 下 的 字符 设备 是 指 设备 发 送 和 接收 数据 以 字符 的 形式 进行 。 


对 设备 文件 进行 打 


和 读 写 操作 。Linux 包含 如 下 三 类 设备 驱动 程序 : 


D IN 


字符 设备 接 


支持 面向 学 


符 的 IO 操作 ， 数 据 不 经 过 系统 的 快速 缓存 ， 


接口 只 支持 顺序 存 取 的 有 限 长 度 的 VO 操作 。 典 型 的 字符 设备 包括 串口 


QD 块 设备 


块 设备 是 以 块 的 方式 进 


驱动 本 身 负责 管理 


aM 


区 结构 。 人 字符 设备 


、LED 灯 、 键 盘 等 设备 。 


行 IO 操作 的 。 块 设备 是 利用 一 块 系统 内 存 作 组 ; 


区 ， 用 来 临时 


存放 块 设备 的 数据 。 当 缓存 的 数据 请 求 达到 一 定数 量 ， 会 对 设备 进行 读 写 操作 。 块 设备 是 主 


要 针对 磁盘 等 慢 速 设备 设 训 
功能 ， 也 
SD 卡 等 存 


据 的 传递 。Linux 操作 系统 文 持 对 发 送 数据 和 接收 数据 的 缓存 ， 提 供 流量 控制 机 制 ， 也 提供 


几乎 可 以 支持 外 


F 意 位 


We. 
(3) 网 络 设备 


的 ， 以 免 读 写 设备 耗费 过 多 的 CPU 时 
于 和 任意 长 度 的 IO 请 求 。 典 型 的 块 设备 包括 硬盘 、 


间 。 抉 设备 文 持 随 机 存 取 


CF 卡 、 


Linux 操作 系统 中 的 网 络 设备 是 一 类 特殊 的 设备 。Linux 的 网 络 子 系统 主要 是 基于 BSD 
UNIX 的 socket 机 制 。 在 网 络 子 系统 和 了 驱动 程序 之 间 定 义 有 专门 的 数据 结构 (sk_bu 角 进行 数 


对 多 种 网 络 协议 的 支持 。 


型 ， 


备 号 。 从 设备 号 则 
每 一 个 字符 设备 或 块 设备 
设备 节点 。 网 络 设备 在 文件 系统 的 /dev H 
备 。 字 符 设 备 和 块 设备 的 设备 节点 在 /dev 


Linux 系统 为 每 个 设备 分 配 了 一 个 主 设备 号 与 次 设备 号 ， 了 


次 设备 号 标识 具体 设备 的 实例 。 由 同一 个 设备 驱动 程序 控制 


利 来 区 分 具有 相同 主 设备 号 的 不 同 设备 。 


[root@/dev]#ls -1 [more 


CrWw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- 1 root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
Crw-rw---- ] root root 
brw-rw---- ] root root 
brw-rw---- ] root root 
brw-rw---- ] root root 
brw-rw---- ] root root 
brw-rw---- ] root root 
brw-rw---- ] root root 


E 文 件 系统 


录 


CA 


13, 
90, 
90, 
90, 
90, 
90, 
90, 
90, 
90, 
E 
31, 
31, 
ala 
43, 
43, 


1 Dec 31 19:00 console 
63 Dec 31 19:00 mice 

0 Dec 31 19:00 mtd0 

1 Dec 31 19:00 mtdOro 

2 Dec 31 19:00 mtdl 

3 Dec 31 19:00 mtdlro 

4 Dec 31 19:00 mtd2 

5 Dec 31 19:00 mtd2ro 

6 Dec 31 19:00 mtd3 

7 Dec 31 19:00 mtd3ro 


0 Dec 31 19:00 mtdblock0 
] Dec 31 19:00 mtdblock1 
2 Dec 31 19:00 mtdblock2 
3 Dec 31 19:00 mtdblock3 


0 Dec 31 19:00 nbd0 
1 Dec 31 19:00 nbd1 


= 设备 号 唯 


标识 了 设备 类 


的 所 有 设备 


只 有 相同 的 主 设 


都 有 一 个 特殊 设备 文件 与 之 对 应 ， 这 个 文件 就 是 
中 没有 节点 ， 应 用 层 可 以 通过 套 接 字 访问 网 络 设 
目录 下 面 : 


rA ^L 


FITIN 
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每 行 第 一 个 字母 为 c 表示 字符 设备 ， 为 b 表示 块 设备 。 上 面 第 4 列 就 是 设备 的 主 设 
4 5 列 为 设备 的 次 设备 号 ， 最 后 一 列 为 设备 节点 的 名 称 。/dev 下 面 有 两 个 虚拟 设备 ， 


即 /dewnull 5E/dev/zero. /dev/null 是 一 个 


段 值 为 0 的 二 进 制 流 。 如 下 面 的 语句 有 


空 设 备 ， 写 入 与 读 取 数 据 均 没 有 反馈 。cat afile > 
/dev/null 将 不 会 有 输出 。cat /dev/null > afile 会 清空 afile 文件 的 内 容 。 访 问 /dev/zero 会 得 到 一 


H 0 填充 ttxt 文件 : 


# dd if=/dev/zero of-/home/t.txt bs=1024 count=768 


Character devices: 


] mem 
4 /dev/vc/0 
5 /dev/tty 
7 ves 
14 sound 
89 i2c 
128 ptm 
189 usb device 
254 rtc 
Block devices: 
] ramdisk 
8 sd 
65 sd 


1.2.1 file operations 结构 
对 于 字符 设备 可 
虚拟 文件 系统 (VFS) 的 文件 接 
到 相应 的 设备 到 


struct module *owner; 
loff t (*llseek) (struct file *, loff t, int); 


备 驱 动 程序 原理 


周 用 对 设备 文件 进 和 


K 动 程序 ， 并 调用 相应 的 对 


struct file operations { 


另外 字符 设备 与 块 设 备 也 可 以 通过 /proc/devices 文件 查看 ; 
ES 为 节省 篇 幅 ， 以 下 对 原 


[root@urbetter proc | cat devices 


端 输出 做 了 重新 排版 ， 数 字 为 设备 号 ， 英 文 为 设备 名 


E 


pty 3 ttyp 

tty 4 ttyS 
/dev/console 5 /dev/ptmx 
misc 13 input 

sg 29 fb 

mtd 116 alsa 

pts 180 usb 
ttySAC 253 ttySDIO 
blkext 7 loop 
mtdblock 43 nbd 


K 动 程序 ， 最 核心 的 就 是 file operations 结构 ， 这 个 结构 实际 上 是 提供 给 
， 它 的 每 一 个 成 员 函 数 一 般 都 对 应 一 个 系统 调用 。 用 户 进 
诸如 读 和 写 等 操作 时 ， 系 统 调用 通过 设备 文件 的 主 设备 号 找 
K 动 程序 函数 。file_operations 结构 定义 如 下 : 


/模块 所 有 者 


ssize t(*read) (struct file *, char — user *, size_t, loff t *); // 读 

ssize t (*write) (struct file *, const char _ user *, size t, loff t *); ns 

ssize t(*read iter) (struct kiocb *, struct iov iter *); /多 缓冲 读 

ssize t (*write iter) (struct kiocb *, struct iov iter *); Ie 

int (*iterate) (struct file *, struct dir context *); 

unsigned int (*poll) (struct file *, struct poll table struct *); // 查 询 可 读 性 

long (*unlocked ioctD (struct file *, unsigned int, unsigned long); /未 加 锁 的 控制 接口 
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/在 64 位 系统 上 处 理 32 位 的 ioctl 调用 


long (*compat ioctb (struct file *, unsigned int, unsigned long); 


int (*mmap) (struct file *, struct vm area struct *); /内 存 映 射 

int (*open) (struct inode *, struct file *); /打开 设备 

int (*flush) (struct file *, fl owner t id); /执行 未 完成 的 操作 

int (*release) (struct inode *, struct file *); /释放 

int (*fsync) (struct file *, loff t, loff t, int datasync); /刷新 待 处 理 的 数据 

int(*aio fsync) (struct kiocb *, int datasync); /异步 刷新 待 处 理 的 数据 

int (*fasync) (int, struct file *, int); /通知 设备 FASYNC 标志 发 生变 化 
int (*lock) (struct file *, int, struct file lock *); /文件 锁 


/发 送 数据 , 一 次 一 页 
ssize t (*sendpage) (struct file *, struct page *, int, size t, loff t *, int); 
unsigned long (*get unmapped area)(struct file *, unsigned long, unsigned long, unsigned long, 


unsigned long); /获取 未 映射 区 
int (*check flags)(inb; /检查 传递 给 fcntl(fd,F_SETEL...) 调 用 的 标志 
int (*flock) (struct file *, int, struct file lock *); / 另 一 种 文件 锁 


ssize_t (*splice write)(struct pipe inode info *, struct file *, loff t *, size t, unsigned int); 
ssize t(*splice read)(struct file *, loff t *, struct pipe inode info *, size t, unsigned int); 
int (*setlease)(struct file *, long, struct file lock **, void **); 
long (*fallocate)(struct file *file, int mode, loff t offset,loff t len); 
void (*show fdinfo)(struct seq file *m, struct file *f); 
#ifndef CONFIG MMU 
unsigned (*mmap capabilities)(struct file *); 
#endif 
ssize_t (*copy_file_range)(struct file *, loff t, struct file *,loff t, size_t, unsigned int); 
int (*clone file range)(struct file *, loff t, struct file *, loff t;u64); 
ssize t (*dedupe file range)(struct file *, u64, u64, struct file *,u64); 
h 
注意 unlocked ioctl 已 经 取代 了 旧 内 核 的 ioctl 接口 ，ioctl 是 BKL (Big Kernel Lock) 模 式 
下 的 控制 接口 。 在 内 核 中 ，file 结构 代表 一 个 打开 的 文件 ，file 在 执行 file operation. 中 的 
open 操作 时 创建 。 假 设 驱动 程序 中 定义 的 file operation 是 fops， 图 1-4 是 应 用 层 系统 调用 与 
区 动 层 fops 的 调用 关系 图 。 


O 


Rui 


fd-open("/dev/XX") ioctl(fd) write(fd) read(fd) close(fd) 


| 1 1 ë y 
虚拟 文件 系统 


图 1-4 应 用 层 与 驱动 层 的 调用 关系 
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file operations 的 open 与 release 接口 的 第 一 个 参数 是 inode 结构 。 该 结构 被 内 核 用 来 表 
示 一 个 文件 节点 ， 也 就 是 一 个 具体 的 文件 或 目录 。 文 件 节点 的 操作 结构 定义 如 下 : 


struct inode operations { 
struct dentry * (*lookup) (struct inode *,struct dentry *, unsigned int); 
const char * (*get link) (struct dentry *, struct inode *, struct delayed call *); 
int (*permission) (struct inode *, int); 
struct posix acl * (*get acl)(struct inode *, int); 
int (*readlink) (struct dentry *, char — user *,int); 


int (*create) (struct inode *,struct dentry *, umode t, bool); /创建 

int (*link) (struct dentry *,struct inode *,struct dentry *); // 便 链接 
int (*unlink) (struct inode *,struct dentry *); /取消 链接 
int (*symlink) (struct inode *,struct dentry *,const char *); // 软 链接 
int (*mkdir) (struct inode *,struct dentry *,umode t); // 创 建 目录 
int (*rmdir) (struct inode *,struct dentry *); /删除 目录 
int (*mknod) (struct inode *,struct dentry *,umode t,dev t); /创建 节点 


重合 名 


int (*rename2) (struct inode *, struct dentry *,struct inode *, struct dentry *, unsigned int); 


int (*rename) (struct inode *, struct dentry *,struct inode *, struct dentry *); —//& 


ja) 


int (*setattr) (struct dentry *, struct iattr *); 

int (*getattr) (struct vfsmount *mnt, struct dentry *, struct kstat *); 

int (*setxattr) (struct dentry *, const char *,const void *,size tint); 

ssize t (*getxattr) (struct dentry *, const char *, void *, size t); 

ssize t (*listxattr) (struct dentry *, char *, size t); 

int (*removexattr) (struct dentry *, const char *); 

int (*fiemap)(struct inode *, struct fiemap extent info *, u64 start,u64 len); 

int (*update time)(struct inode *, struct timespec *, int); /更 新 时 间 

int (*atomic open)(struct inode *, struct dentry *,struct file *, unsigned open flag, 
umode tcreate mode, int *opened); 

int (*tmpfile) (struct inode *, struct dentry *, umode t); 

int (*set acl)(struct inode *, struct posix acl *, int); 

)  . cacheline aligne 


12.20 [EH] register chrdev 注册 字符 设备 
注册 字符 设备 可 以 使 用 register chrdev 函数 。 


int register chrdev (unsigned int major, const char *name, struct file operations*fops); 


register chrdev 函数 的 major 参数 如 果 等 于 0， 则 表示 采用 系统 动态 分 配 的 主 设备 号 。 
注销 字符 设备 可 以 使 用 unregister chrdev 函数 。 


int unregister chrdev(unsigned int major, const char *name); 


15) 1.4 register chrdev 注册 字符 设备 实例 
代码 见 \samples\1door\1-3register chrdev。 核 心 代 码 如 下 所 示 : 


static unsigned char simple inc=0; 
static unsigned char demoBuffer[256 |; 
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int simple open(struct inode *inode, struct file *filp) 


1 
if(simple inc>0)return -ERESTARTS YS; 
simple inc++; 
return 0; 
j 
int simple release(struct inode *inode, struct file *filp) 
1 
simple inc--; 
return 0; 
j 
ssize_t simple read(struct file *filp, char __user *buf, size_t count, loff t *f pos) 
1 
入 把 数据 复制 到 应 用 程序 空间 */ 
if (copy_ to user(buf,demoBuffer,count)) 
{ 
count=-EFAULT; 
j 
return count; 
j 
ssize t simple write(struct file *filp, const char — user *buf, size t countloff t *f pos) 
1 
/* 把 数据 复制 到 内 核 空间 */ 
if (copy from user(demoBuffer+*f pos, buf, count)) 
1 
count = -EFAULT; 
j 
return count; 
j 
struct file operations simple fops = { 
.owner = THIS MODULE, 
read = simple read, 
.Write = simple write, 
open = simple open, 
release — simple release, 
h 
[FER rk sk e sk ke ok e oe se e ke k k eoe oleo kak ese ak aak peo ae ak ake ak ook ake a ake ake ake ake ake ake ak ake ak ake ake ake 


MODULE ROUTINE 


3e aE 34e ake sk oke 34e 34e sje oko ood eoe ese ok 34€ 3HE siete ahe ae eese seo oko spo aH ae ae ahe sfe afe afeafe ahe 3HE abe 3HE ahe HRE Skea a 


void simple cleanup module(void) 


1 
unregister chrdev(simple MAJOR,  "simple"); 
printk("simple cleanup module!in"); 

} 

int simple init module(void) 

1 
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j 


int ret; 
/注册 字符 设备 


y 


LH 


1# 


ret = register chrdev(simple MAJOR, "simple", &simple fops); 


if (ret < 0) 
1 


Linux 设备 驱动 程序 入 门 


printk("Unable to register character device %d!\n",simple MAJOR); 


return ret; 


j 


return 0; 


module init(simple init module); 


module exit(simple cleanup module); 


应 用 程序 的 代码 如 下 : 
void main(void) 
{ 
int fd; 
int i; 
char data[256]; 
int retval; 


fd=open("/dev/fej",O RDWR); 
if(fd——-1) 
1 
perror("error open"); 
exit(-1); 
j 
printf("open /dev/fgj successfully"); 
/ 写 数 据 
retval-write(fd," fgj",3); 
if(retval==-1) 
{ 
perror("write error"); 
exit(-1); 
} 

// 读 数据 
retval=read(fd,data,3); 
if(retval==-1) 

{ 


perror("read error\n"); 
exit(-1); 
} 
data[retval]-0; 
printf("read successfully:96s Wn", data); 
/关闭 设备 
close(fd); 
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字符 设备 模块 使 用 insmod 加 载 ， 加 载 完毕 需要 在 /dev 目录 下 使 用 mkmod 命令 建立 相应 


的 文件 节点 


。 编 译 生成 的 应 用 层 可 执行 程序 为 test。 本 例 运 行 结果 如 下 : 


[root@/homel#insmod demo.ko 

[root@urbetter /homel# mknod /dev/fej c 224 0 
[root@urbetter /home |? ./test 

open /dev/fgj successfully 


read successfully:fgj 


1.23 [EHI cdev add 注册 字符 设备 
实际 上 register chrdev 函数 调用 了 cdev add 函数 。 在 Linux 内 核 中 的 字符 设备 用 cdev 


其 定义 如 下 : 


struct cdev 
1 
struct kobject kobj; 
struct module *owner; /所 属 模块 


li 


const struct file operations *ops; /文件 操作 结构 


struct list head list; 
dev t dev; /设备 号 ， 
unsigned int count; 


int 类 型 ， 高 12 位 为 主 设备 号 ， 低 20 位 为 次 设备 号 


下 面 一 组 函数 用 来 对 cdev 结构 进行 操作 : 


struct cdev *cdev alloc(void);// 分 配 一 个 cdev 
void cdev init(struct cdev *, const struct file operations *);// 初 始 化 cdev 的 file operation 
void cdev. put(struct cdev *p);// /减少 使 用 计数 


// 注 


int 


/R3 
void cdev del(: 


使 用 cdev add 注册 字符 设备 前 应 该 先 调用 register chrdev region 或 alloc_ chrdev region 


EAE. EREE 


cdev add(struct cdev *p 


FE 销 设备 ， 通 常 发 生 在 到 


struct cdev *p); 


K 动 模块 的 加 载 函 数 中 
, dev t dev, unsigned count) ; 


KJ PS ERI E EU n 


4) ROUES. register chrdev region 函数 用 于 指定 设备 号 的 情况 ，alloc_chrdev_region 函数 用 


于 动态 申请 设备 号 ， 系 统 


动 返回 没有 占用 的 设备 号 。 


int register chrdev region(dev t from, unsigned count, const char *name) ; 


intalloc chrdev region(dev t *dev,unsigned baseminor,unsigned count,const char *name); 


register chrdev region 函数 申请 从 from 开始 的 count 个 主 设备 写 。alloc_chrdev_region H 
请 一 个 动态 主 设备 号 ， 并 


号 的 数量 。 注 销 设 备 号 (cdev_del) 后 使 用 unregister chrdev region: 


请 


系列 次 设备 号 。baseminor 是 起 始 次 设备 号 ，count 为 次 设备 


void unregister chrdev region(dev t from,unsigned count) ; 


15) 1.5. cdev add 注册 字符 设备 实例 
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代码 见 \samples\1doorn\1-4cdev。 核 心 代码 如 下 所 示 : 


struct file operations simple fops={ 
.owner = THIS MODULE, 


read = simple read, 
.Write = simple write, 
open = simple open, 
release = Simple release, 
h 
DLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLELLLLLLLLLELLLLLLLLLLI 
/ 


MODULE ROUTINE 

米 米 米 洲 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 / 
void simple cleanup module(void) 
{ 

dev tdevno = MKDEV(simple MAJOR, simple MINOR); 

if (simple devices) 

{ 

cdev_del(&simple devices->cdev); 
kfree(simple devices); 

j 

unregister chrdev region(devno,l); 
j 
/模块 初始 化 
int simple init module(void) 
{ 

int result; 

dev t dev = 0; 

dev - MKDEV(simple MAJOR, simple MINOR); 

result = register chrdev region(dev, 1, "DEMO"); // 申 请 设备 号 

if (result « 0) 

{ 


printk(KERN WARNING "DEMO: can't get major %d\n", simple MAJOR); 
return result; 

j 

simple devices = kmalloc(sizeof(struct simple dev), GFP. KERNEL); /分 配 设备 结构 

if(!simple devices) 

{ 
result --ENOMEM; 
goto fail; 

) 

memset(simple devices, 0, sizeof(struct simple dev)); 

/初始 化 设备 结构 

cdev init(&simple devices->cdev, &simple fops); 

simple devices-»cdev.owner = THIS MODULE; 

simple devices-»cdev.ops = &simple fops; 

result = cdev add (&simple devices-»cdev, dev, 1); /添加 字符 设备 

if(result) 
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1 
printk(KERN NOTICE "Error %d adding DEMOwW", result); 
goto fail; 
} 
return 0; 
fail: 
simple cleanup module(); 
return result; 
} 


module init(simple init module); 
module exit(simple cleanup module); 


本 例 的 应 用 层 代 码 与 运行 结果 同上 例 。 
1.2.4 ”字符 设备 的 读 写 

在 应 用 程序 看 来 ， 字 符 设备 只 是 一 个 设备 文件 ， 应 用 程序 可 以 像 操 作 普 通 文件 一 样 对 硬 
件 设备 进行 操作 。 应 用 层 对 设备 的 操作 都 在 设备 驱动 程序 的 file operations 结构 中 有 对 应 的 
接口 ， 如 应 用 层 的 read 函数 对 应 驱动 层 的 file operations-^ read， 应 用 层 的 write 函数 对 应 驱 
动 层 的 file_operations->write。 本 节 介 绍 字符 设备 内 核 空间 与 用 户 空 间 数据 交互 的 方法 。 

先 看 file operations 结构 中 的 读 写 接口 ; 


ssize_t (*read) (struct file *, char — user *, size t, loff t *); 


ssize t (*write) (struct file *, const char — user *, size t, loff t *); 
它们 的 第 二 个 参数 实际 上 是 用 户 空间 的 数据 地 址 。 由 于 内 核 态 和 用 户 态 使 用 不 同 的 内 存 
定义 ， 所 以 二 者 之 间 不 能 直接 访问 对 方 的 内 存 ， 而 应 该 使 用 Linux. 中 的 用 户 和 内 核 态 内 存 交 
HORA, XERME include/asm/uaccess.h 中 声明 。 
从 内 核 空 间 向 用 户 空 间 复制 数据 使 用 copy. to user 函数 : 
unsigned long copy to user(void _ user * to, const void * from, unsigned long n); 


而 从 用 户 空间 复制 数据 到 内 核 空 间 可 以 使 用 copy. from. user 函数 ; 


unsigned long copy. from user (void * to, const void* from, unsigned long n); 


此 外 ， 内 核 空间 和 用 户 空 间 之 间 也 可 进行 单 值 交互 〈 如 char. int. long 类 型 ) : 
put user(x, p) /向 用 户 空 间 指 针 p 传单 值 x 
get user(x, p) /从 用 户 空 间 指针 p 读 单 值 x 
当 一 个 指针 指向 用 户 空 间 时 ， 必 须 确保 指向 的 用 户 地 址 是 合法 的 ， 而 且 对 应 的 页 面 也 已 
经 映射 。 这 一 点 可 以 使 用 access ok 函数 检测 。access_ok 函数 的 type 参数 有 两 个 选项 : 
VERIFY_READ、VERIFY_WRITE， 分 别 对 应 于 内 存 读 和 写 。 


int access ok(int type, const void *addr, unsigned long size); 
在 访问 用 户 空间 的 内 存 时 ， 可 以 使 用 下 面 的 方法 先 检 查 用 户 空间 的 指针 是 否 合法 : 


char kernelbuffer[100]; 
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static ssize t demo read(struct file *file, char — user *buffer, size t count, loff t *ppos) 


1 
if(laccess ok(VERIFY WRITE, buffer, count)) 
return -EFAULT; 
if(copy to user(buffer, kernelbuffer, count)) 
return -EFAULT; 
return count; 


j 
12. IOCTL 接口 


IOCTL 接口 主要 用 来 进行 VO 控制 ， 应 用 程序 可 以 通过 IOCTL 接口 向 设备 发 送 命令 、 
参数 设置 等 信息 。file_ operations 结构 中 对 应 的 IOCTL 接口 函数 原型 如 下 : 


long (*unlocked ioctD (struct file *file, unsigned int cmd, unsigned long arg); 


中 cmd 是 命令 类 型 ，arg 是 参数 。 


例 1.6 字符 设备 IOCTL 实例 
代码 见 \samples\1doon1-5ioctl。 核 心 代码 如 下 所 示 : 


#define COMMANDI 0x11 
#define COMMAND2 0x12 
/内 核 IOCTL 接 
int simple ioctl(struct inode *inode, struct file *filp,unsigned int cmd, unsigned long arg) 
{ 
switch(cmd) 
i 
case COMMANDI: 
memset(demoBuffer,0x3 1,256); 
break; 
case COMMAND2: 
memset(demoBuffer,0x32,256); 
break; 
default: 
return -EFAULT; 
break; 
j 
return 0; 
j 


struct file operations simple fops = { 
.owner = THIS MODULE, 
unlocked ioctl = simple ioctl, 
open = simple open, 
release — simple release, 


js 
接 下 来 编写 一 个 应 用 程序 ， 参 考 代 码 如 下 : 
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void main(void) 
{ 
int fd; 
int i; 
char data[256]; 
int retval; 
fd-open("/dev/fgj",|O RDWR); 
if(fd——-1) 
i 
perror("error open"); 
exit(-1); 
j 
printf("open /dev/fgj successfully"); 
/应 用 层 YOCTL 558 
retval=ioctl(fd,COMMAND1,0); 
if(retval==-1) 
{ 


qu 


perror("ioctl error"); 
exit(- 1); 
} 


printf("send command] successfully"); 


retval-ioctl(fdjCOMMAND2,0); 
if(retval==-1) 
{ 
perror("ioctl error\n"); 
exit(-1); 
j 


printf("send command] successfully"); 


close(fd); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter /homel# insmod demo.ko 


[root@urbetter /homel# mknod /dev/fej c 224 0 


[root(Q)urbetter /home |? ./test 
open /dev/fgj successfully 

send command] successfully 
send command2 successfully 


I4 


unlocked ioctl 函数 中 的 命令 参数 cmd 不 能 随意 定义 ， 有 一 些 值 已 经 被 系统 使 用 ， 就 不 


设备 驱动 中 使 用 ， 否 则 会 发 生 冲 突 。 例 如 : 


#define FIBMAP _IO(0x00,1) 
#define FIGETBSZ —— IO(0x00,2) 
#define FIFREEZE IOWR(X', 119, int) 
#define FITHAW —. IOWR(X,, 120, int) 


/[* 
/[* 
/[* 
Æ 


访问 bmap */ 

获取 bmap 的 块 大 小 */ 
冻结 */ 

fu / 


内 核 代码 /fs/ioctl.c 中 的 do vfs ioct 函数 对 这 些 特殊 的 cmd 做 了 处 理 : 


实际 上 ，IOCTL 接 


第 1 章 Linux 设备 驱动 程序 入 门 


#define FITRIM _IOWR('X', 121, struct fstrim range) /* 剪裁 */ 
#define FICLONE _IOW(0x94, 9, int) 

#define FICLONERANGE IOW(0x94, 13, struct file clone range) 

#define FIDEDUPERANGE - IOWR(0x94, 54, struct file dedupe range) 


int do vfs ioctl(struct file *filp, unsigned int fd, unsigned int cmd,unsigned long arg) 
1 
int error = 0; 
int user*argp = (int user *Jarg; 
struct inode *inode = file inode(filp); 
switch (cmd) ( 
case FIOCLEX: 
set close on exec(fd, 1); 
break; 


case FS IOC FIEMAP: 
return ioctl. fiemap(filp, arg); 
case FIGETBSZ: 


return put user(inode-^i sb-»s blocksize, argp); 


default: 
if(S ISREG(inode-i mode)) 
error = file ioctl(filp, cmd, arg); 


else 
error = vfs ioctl(filp, cmd, arg); 
break; 
} 
return error; 


j 


Hn 


P] cmd 参数 每 个 位 都 有 特殊 的 含义 ， 见 表 1-1。 


表 1-1 cmd 参数 每 个 位 的 含义 


位 Bit31 一 Bit30 Bit29 一 Bit16 Bit15 一 Bit8 Bit7 —BitO 
定义 Dir Size TYPE NR 
p 区 别 读 写 arg 变量 传送 的 数据 大 小 类 型 


TYPE 范围 为 0~255， 通 常用 英文 字符 "A"~"2" 或 者 "a"~"z" 来 表示 。 设 备 驱 动 程序 


从 传递 进来 的 命令 获取 TYPE， 然 后 与 自身 能 处 理 的 TYPE 进行 比较 ， 如 果 相 同 则 处 理 ， 不 


同 则 不 处 理 。 用 于 创建 IOCTL 接口 命令 的 宏 包 括 : 


#define IO(type;nr) _IOC( IOC NONE,(type),(nr),0) 

#define IOR(type;nrsize) IOC( IOC READ,(type),(nr),( IOC TYPECHECK(size))) 
#define IOW(type,nt,size) IOC( IOC WRITE,(type),(nr),( IOC TYPECHECK(size))) 
#define IOWR(type;nrsize) IOC( IOC READ| IOC WRITE,(type),(nn),( IOC TYPECHECK(size))) 
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#define IOR_BAD(type,nrsize) 


_IOC( IOC READ.(type),.(nr),sizeof(size)) 


#define IOW BAD(type,nrsize)  IOC( IOC WRITE;(type).(nr),sizeof(size)) 


#define IOWR BAD(type,nt,size) IOC( IOC READ| IOC WRITE;(type).(nr),sizeof(size)) 


用 于 解码 IOCTL 命令 的 宏 包括 : 


#define IOC DIR(nr) 
#define IOC TYPE(nr) 


#define IOC NR(nr)  (((nr)»» IOC NRSHIFT) & IOC NRMASK) 


#define IOC SIZE(nr) 


音频 驱动 中 的 几 个 IOCTL 命令 的 组 装 示例 : 


下 面 是 


#define SNDRV. TIMER IOCTL INFO 
#define SNDRV. TIMER IOCTL PARAMS 
#define SNDRV. TIMER IOCTL STATUS 


1.2.6 seek 接口 


字符 设备 只 能 按 顺序 读 写 ， 上 次 操作 的 结束 位 置 就 是 当前 读 写 位 置 


(((nn) >> IOC DIRSHIFT) & IOC DIRMASK) 
((nr)-»» IOC TYPESHIFT) & IOC TYPEMASK) 


((nr) >> IOC SIZESHIFT) & IOC SIZEMASK) 


IOR(T', 0x11, struct snd timer info) 
_IOW('T', 0x12, struct snd timer params) 
_IOR('T', 0x14, struct snd timer status) 


备 的 读 写 位 置 


进行 重 定位 。file_operations 结构 中 对 应 的 seek 接口 如 下 : 


loff t (*llseek) (struct file *filp, loff t off, int whence) 


(5 1.7 


中 ，o 任 是 偏 移 量 ，whence 参数 指 起 点 位 置 。 


字符 设备 seek 实例 


代码 见 \samples\1doon\1-6lseek。 核 心 代码 如 下 所 示 : 


t, seek 接 


ssize tsimple read(struct file *filp, char — user *buf, size t count,loff t *f pos) 


1 
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loff t pos- *f pos;/ 获 取 文 件 指针 
ifpos»—256) 


1 

count-0; 

goto out; 
j 
if(count*(256-pos)) 
{ 

count=256-pos; 
} 


pos += count; 
/复制 数据 到 指定 的 地 址 
if (copy to user(buf,demoBuffer-*f pos,count)) 
{ 
count--EFAULT; 
goto out; 
j 
*f pos — pos; 


来 对 设 
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out: 
return count; 
} 
loff t simple llseek(struct file *filp, loff t off, int whence) 
1 
loff t pos; 
pos = filp-^f pos; 
switch (whence) 
1 
case 0: 
pos = off 
break; 
case 1: 
pos += off 
break; 
case 2: 
pos =255+off; 
break; 
default: 
return -EINVAL; 
} 
if ((pos>=256) || (pos<0)) 
{ 
return -EINVAL; 
j 
return filp-^f pos-pos; 
} 
struct file operations simple fops={ 
.owner = THIS_MODULE, 
.seek= simple llseek, 
read = simple read, 
open = simple open, 
release — simple release, 


is 


应 用 程序 参考 代码 如 下 : 


void main() 
1 
int fd; 
int i; 
char data[256]; 
int retval; 
fd—open("/dev/fgj",O. RDWR); 
if(fd——-1) 
{ 


perror("error open\n"); 
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exit(-1); 
} 
printf("open /dev/fgj successfully"); 
retval-Iseek(fd,5,0); 
if(retval==-1) 
{ 
perror("Iseek error\n"); 
exit(-1); 
} 
retval-read(fd,data,3); 
if(retval==-1) 
{ 
perror("read error\n"); 
exit(-1); 
j 
data[retval]-0; 
printf("read successfully:9osWn",data); 
/文件 定位 
retval=lseek(fd,2,0); 
if(retval==-1) 
1 


perror("Iseek error"); 
exit(-1); 

j 

retval-read(fd,data,3); 

if(retval==-1) 

{ 
perror("read error\n"); 
exit(-1); 

j 

data[retval]-0; 

printf("read successfully:?osWn",data); 

close(fd); 

j 


本 例 运行 结果 如 下 : 


[root@urbetter /homel# insmod demo.ko 
[root@urbetter /homel# mknod /dev/fej c 224 0 
[root(Q)urbetter /home |? ./test 

open /dev/fgj successfully 

read successfully: FGH 

read successfully: CDE 


12. poll 接口 


22 


如 果 设 备 被 设置 成 阻塞 式 操 作 ， 即 当 设备 执行 VO 操作 时 ， 如 果 不 能 获得 数据 ， 将 阻 
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Ne 


塞 ， 直 到 获得 数据 。 应 用 层 可 以 使 用 select. 函数 查询 设备 当前 的 状态 ， 以 便 用 户 程序 获知 是 
否 能 对 设备 进行 非 阻塞 的 访问 。 使 用 select 函数 需要 在 设备 驱动 程序 中 添加 file operations- 
>poll 接口 支持 。 一 个 典型 的 字符 驱动 程序 的 包 e_operations->poll 函数 的 实现 如 下 ; 


static unsigned int my_poll(struct file *file, struct poll table struct *wait) 


{ 
unsigned int mask = 0; 
poll_wait(file, & outq, wait); // 把 当前 进程 添加 到 等 待 列 表 
if (0 != bta->read count) ”// 如 果 有 数据 
mask |= (POLLIN | POLLRDNORM); 
return mask; 
} 


驱动 程序 中 的 poll 函数 返回 的 标志 如 下 : 


#define POLLIN 0x0001 /设备 可 以 无 阻塞 地 读 取 

#define POLLPRI 0x0002 /设备 可 以 无 阻塞 地 读 取 高 优先 级 数据 ( 带 外 数据 ) 
#define POLLOUT 0x0004 /设备 可 以 无 阻塞 地 写 入 

#define POLLERR 0x0008 /设备 发 生 错 误 

#define POLLHUP 0x0010 / 当 读 取 设 备 的 进程 到 达 文 件 尾 部 

#define POLLNVAL 0x0020 /请 求 无 效 

#define POLLRDNORM 0x0040 IF URS CAMA 


"define POLLWRNORM 4/* POLLOUT */ 
#define POLLRDBAND 0x0080 /可 以 从 设备 读 带 外 数据 


#define POLLWRBAND 256 /可 以 向 设备 写 带 外 数据 
#define POLLMSG 0x0400 
#define POLLREMOVE 0x1000 
#define POLLRDHUP 0x2000 


应 用 层 多 路 VO 选择 函数 select 的 原型 如 下 : 


int select(int numfds, fd set *readfds, fd set *writefds, fd set *exceptfds, struct timeval *timeout); 


readfds, writefds,. exceptfds 分 别 是 被 select 函数 监视 的 读 、 写 和 异常 处 理 的 文件 
描述 符 集合 ，numfds 的 值 为 需要 监视 的 号 码 最 高 的 文件 描述 符 加 1。timeout 参数 是 一 个 指 
J timeval 结构 类 型 的 指针 ， 是 超时 时 间 。select 函数 在 两 种 情况 下 会 返回 ， 一 种 是 所 监视 的 
设备 中 有 一 些 设备 可 读 、 可 写 或 发 生 异 常 ， 另 一 种 是 超时 时 间 到 达 。 文 件 描述 符 集 常用 函数 
接口 如 下 : 


可 


FD ZERO(fd set *set) // 清 除 一 个 文件 描述 符 集 
FD SET(int fd,fd set *set) /将 文件 描述 符 fd 加 入 文件 描述 符 集 中 
FD CLR(int fd,fd set *set) /将 文件 描述 符 fd. 从 文件 描述 符 集中 清除 


FD ISSET(int fd,fd set *set) /判断 文件 描述 符 fd 是 否 被 置 位 


例 1.8 poll 接口 驱动 程序 示例 
代码 见 \samples\ldooml1-7poll。 核 心 代 码 如 下 所 示 ; 


ssize tsimple read(struct file *filp, char — user *buf, size tcountlo 任 fxf pos) 
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1 
wait event interruptible(read queue, simple flag); 
if (copy to user(buf,demoBuffer,count)) 
1 
count--EFAULT; 
} 
return count; 
} 
ssize tsimple write(struct file *filp, const char — user *buf, size t count,loff t *f pos) 
1 
if(copy from user(demoBuffer, buf, count)) 
1 
count = -EFAULT; 
goto out; 
} 


simple flag-1; 
wake up(&read queue); 


out: 
return count; 
j 
/poll 接口 实现 
unsigned int simple poll(struct file * file, poll table * pt) 
1 
unsigned int mask = POLLIN | POLLRDNORM; 
poll wait(file, &read queue, pt); 
return mask; 
j 
struct file operations simple fops = { 
.Owner = THIS MODULE, 
.poll = simple poll, 
read = simple read, 
.Write= simple write, 
open = simple open, 
release — simple release, 
js 
应 用 程序 参考 代码 如 下 : 
int fd; 
void *readthread(void *arg) // 读 数据 线程 
{ 
char data[256]; 
fd. set rfds; // 读 描述 符 集合 
fd set wfds; // 号 描述 符 集合 
int retval-0; 
while(1) 
1 


FD ZERO(&rfds); 
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FD SET(fd, &rfds); 

select(fd--1, &rfds, &wfds, NULL, NULL); /多 路 选择 
iKFD ISSET(fd, &rfds)) 

{ 


retval=read(fd, data,3); 

if(retval==-1) 

i 
perror("read error n"); 
exit(-1); 

j 

data[retval]-0; 

printf("read successfully:9osW" data); 


} 
return (void *)0; 
} 
void main() 
{ 
int i; 
int retval; 
fd=open("/dev/fej",O_RDWR); 
if(fd==-1) 
{ 
perror("error open"); 
exit(-1); 
} 
printf("open /dev/fgj successfully"); 
pthread t tid; 
pthread create(&tid, NULL, readthread, NULL); /创建 读 线 程 
while(1) 
{ 


retval=write(fd,"fgj",3); // 主 线程 负责 写 数据 
if(retval==-1) 
{ 

perror("write error"); 

exit(-1); 


} 
close(fd); 


j 
本 例 运 行 结果 如 下 : 


[root@urbetter /home |? insmod demo.ko 
[root(Q)urbetter /home]# mknod /dev/fgj c 224 0 
[root(Qurbetter /home]|# ./test 

read successfully:fgj 
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read Successfully:fgj 


read Successfully:fgj 
read successfully:fgj 


12.8 ”异步 通知 


如 果 设 备 驱动 已 经 准备 好 数据 ， 可 以 采用 异步 通知 的 方式 通知 应 用 层 来 读 取 ， 这 样 应 


程序 就 不 需要 一 直 查 询 设 备 的 状态 。 要 文 持 异 步 通知 ， 需 要 实现 字符 设备 驱动 程序 的 fasync 


接口 。 当 一 个 打开 的 文件 的 FASYNC 标志 变化 时 ，file_operations ->fasyncO 接 口 将 被 调 


I 


用 。 


N 


file operations ->fasync 函数 会 调用 fasync helper 函数 从 相关 的 进程 列表 中 添加 或 去 除 异 


步 通 


知 关 联 。fasync_helper 函数 的 定义 如 下 《其 中 on 参数 为 0 表示 去 除 异 步 通知 ， 为 1 表示 添 


加 有 寞 步 通知 ): 
int fasync helper(int fd, struct file * filp, int on, struct fasync struct **fapp); 


当 数 据 到 达 时 ，kill_fasync 函数 将 被 用 来 通知 相关 的 进程 : 


void kill fasync(struct fasync struct **fp, int sig, int band); 


例 1.9 异步 通知 实例 
代码 见 \samples\1doorn\1-8fasync。 了 驱动 层 代 人 码 如 下 : 


struct simple dev *simple devices; 
static unsigned char simple inc=0; 
static struct timer list simple timer; 
static struct fasync struct *fasync queue-NULL; 
int simple open(struct inode *inode, struct file *filp) 
1 
struct simple dev *dev; 
dev = container of(inode-^1i cdev, struct simple dev, cdev); 
filp-^private data = dev; 
simple timer.function = &simple timer handler; 
simple timer.expires — jiffies + 2*HZ; 
add timer (&simple timer); 
printk("add timer...n"); 
return 0; 
} 
// 异 步 通 知 处 理 函数 
static int simple fasync(int fd, struct file * filp, int mode) 


{ 


int retval; 
printk("simple fasync...\n"); 
retval=fasync helper(fd,filpymode,&fasync queue); 
if(retval«0) 
return retval; 
return 0; 
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j 
int simple release(struct inode *inode, struct file *filp) 
1 
simple fasync(-1, filp, 0); 
return 0; 
j 


struct file operations simple fops = { 
.owner = THIS MODULE, 


open = simple open, 
release- simple release, 
.fasync- simple fasync, 
5 
当 数 据 到 达 时 ， 调 用 kill fasync 通知 应 用 层 ， 这 里 采用 定时 器 来 模拟 数据 就 绪 ， 发 出 通知 。 


static void simple timer handler( unsigned long data) 
{ 
printk("simple timer handler...n"); 
if(fasync queue) 
{ 
//POLL IN nfi, POLL OUT 为 可 写 
kill fasync(&fasync queue, SIGIO, POLL IN); 
printk("kill fasync...n"); 
j 


return ; 


注意 : POLL IN 表示 设备 可 读 ，POLL OUT 表示 设备 可 写 。 应 用 层 参考 代码 如 下 : 


int fd; 
void fasync handler(int num) 
1 
printf("fasync handler entering"); 
j 
void main() 
1 
int i—2; 
char data[256]; 
int oflags-0; 
int retval; 
signal(SIGIO, fasync_handler);// 注 册 信 号 处 理 函 数 
fd-open("/dev/fcn",O RDWR); 
if(fd-—-1) 
1 


perror("error open"); 
exit(- 1); 
j 
printf("open /dev/fcn successfully"); 
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/使 能 了 异步 的 通知 到 当前 进程 

fcntl(fd,F_ SETOWN, getpid()); 

oflags-fcntl(fd, F GETFL); 

fcntl(fd, F SETFL, oflags | FASYNC);/ 修 改 文件 标志 
while(1); 

close(fd); 


本 例 运行 结果 如 下 : 


[root@urbetter /home |? insmod demo.ko 
[root(Q)urbetter /homel# mknod /dev/fcn c 226 0 
[root(Qurbetter /home]# ./test 

add timer... 

open /dev/fcn successfullysimple fasync... 


simple timer handler... 
kill fasync... 
fasync handler entering 


1.3 seq file 机 制 


1.3.1 seq file 原理 


MU i 定 的 组 织 结构 ， 文 件 可 以 从 任意 位 置 开 始 读 写 。 有 一 种 文件 与 普通 文 
件 不 同 ， 它 包含 一 系列 的 记录 ， 而 这 些 记录 按照 相同 的 格式 来 组 织 ， 这 种 文件 称 为 顺序 文件 
(sequential fle). seq file 是 专门 处 理 顺 序 文 件 的 接口 。 


struct seq file { 


char *buf; /缓冲 
size t size; /大 小 
size t from; 


size t count; 
size t pad until; 
loff t index; 
loff tread pos; 


u64 version; 
struct mutex lock; // 锁 
const struct seq operations *op; //seq 操作 


int poll event; 
void *private; 


h 
使 用 seq file 需要 包含 头 文件 linux/seq file.h. seq file 的 常用 操作 接口 如 下 : 


int seq_open(struct file *, const struct seq_operations *); ~ // 打 开 
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ssize tseq read(struct file *, char — user *, size t, loff t *); // 读 

loff t seq lseek(struct file *, loff t, int); // 定 位 

int seq_release(struct inode *, struct file *); // 释 放 

int seq_escape(struct seq file *, const char *, const char *); // 写 缓冲 ， 忽 略 某 些 字符 
intseq putc(struct seq file *m, char c); / 把 一 个 字符 输出 到 seq. file 文件 


intseq puts(struct seq file *m, const char *s); / 把 一 个 字符 串 输出 到 seq_file 文件 


seq read. seq lseek. seq release 等 函数 可 以 直接 赋 给 file operations 文件 操作 结构 的 成 


LH 


fà. seq file 结构 通常 保存 在 file 结构 的 private data 中 ， 这 从 seq. open 函数 中 可 以 看 出 : 


int seq open(struct file *file, const struct seq operations *op) 
1 
struct seq file *p; 
WARN ON(file->private data); 
p = kzalloc(sizeof(*p), GFP KERNEL); 
if (!p)return -ENOMEM; 
file-^private data = p; 
mutex init(&p--lock); 
p-70p = op; 
file->f version = 0; 
file->f mode &- —FMODE PWRITE; 
return 0; 


} 
seq operations 结构 是 seq file 机 制 中 所 需要 实现 的 操作 接口 。 


struct seq operations 1 
void * (*start) (struct seq file *m, loff t *pos);// 开 始 操作 ， 返 回 pos 指向 的 记录 
void (*stop) (struct seq file *m, void *v);// 关 闭 操 作 

void * (*next) (struct seq file *m, void *v, loff t *pos); /寻找 seq file 文件 中 的 下 一 个 记录 
int (*show) (struct seq file *m, void *v);// 格 式 化 输出 记录 的 信息 


h 
L3.2 seq file 实例 
seq file 有 两 种 用 法 ， 一 种 是 单个 遍历 方式 ， 即 show 函数 中 只 输出 单个 记录 的 信息 ， 而 


seq operations 中 的 接口 需要 组 合 使 用 ， 另 一 种 方式 只 需要 一 个 show 函数 ， 在 show 函数 中 
集中 输出 所 有 元 素 的 信息 
例 1.10 seq file 单个 遍历 方式 实例 

具体 代码 见 \samples\1doon\1-11seqfile。 本 例 使 用 g seqfile 链表 存储 4 个 记录 。 关 于 链表 
在 后 续 章 节 会 介绍 。 


7 


o 


struct simple record 


1 


struct list head list; 
char name[8]; 
int iflag; 
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5 
static struct list head g seqfile; 
int simple init module(void) 
{ 
INIT LIST HEAD(&g seqfile); 
printk("&g seqfile=%.8x\n",&g seqfile); 
for(i=0;i<4;i++)// 初 始 化 链表 元 素 
{ 
struct simple record*sr; 
sr-kmalloc(sizeof(struct simple record), GFP. KERNEL); 
If(sr-—NULL) return -1; 
memset(sr-^name,0,4); 
sprintf(sr-^name,"sr?6d" 4-1); 
sr->iflag=4-i; 
list_add(&sr->list, &g seqfile); 
printk(" &sr--list[Vod |-90.8x n" 1, &sr-7 list); 
j 
struct list head *pos; 
list for each(pos,&g seqfile) 
{ 
struct simple record*p=list entry(pos, struct simple record,list); 
printk("initfind the %d list element\n",p->iflag); 


} 
下 面 介 绍 如 何 通 过 seq file 读 取 g_seqfile 的 内 容 : 


int simple open(struct inode *inode, struct file *filp) 


1 
struct simple dev *dev; 
if(simple inc>0)return -ERESTARTSYS; 
simple inc++; 
dev = container of(inode-^i cdev, struct simple dev, cdev); 
return seq open(filp, &simple seq ops); 
} 
int simple release(struct inode *inode, struct file *filp) 
{ 
simple inc--; 
return 0; 
} 


struct file operations simple fops={ 
.owner = THIS MODULE, 
.open = simple open, 
ead =seq read, 
.seek = seq 1seek, 
release — simple release 


30 


$13 Linux 设备 驱动 程序 入 门 


seq operations 操作 接口 的 实现 如 下 : 


/显示 操作 ， 显 示 单 个 元 素 
static int simple seq show(struct seq file *m, void *v) 


1 


struct simple record *sr — list entry(v, struct simple record, list); 
printk("simple seq show %d\n",sr->iflag); 
seq printf(m, "name: 96s, iflag:%d\n", sr->name,sr->iflag); 
return 0; 

j 

/开始 操作 

static vold *simple seq start(struct seq file *m, loff t *pos) 


1 


struct list head *Ih-seq list start(&g seqfile, *pos); 
printk("simple seq start *pos-96.8x' n", *pos); 
return lh; 
j 
/获取 下 一 个 元 素 
static void *simple seq next(struct seq file *m, void *v, loff t *pos) 
1 
printk("simple seq next *pos-96.8x n", *pos); 
return seq list next(v, &g seqfile, pos); 
j 
static vold simple seq stop(struct seq file *m, void *v) 
{ 
printk("simple_seq_stop\n"); 
j 
static struct seq operations simple seq ops- ( 
.Start = simple seq start, 
.next — simple seq next, 
.Stop = simple seq stop, 
.show = simple seq show 


i 


应 用 


层 核心 代码 如 F : 


void main() 


一 一 


int fd; 
char data[256]; 
int retval; 
fd-open("/dev/fgji',O RDWR); 
if(fd——-1) 
{ 
perror("error open\n"); 
exit(-1); 


31 


Linux 驱动 程序 开发 实例 第 2 版 


printf("open /dev/fgj successfully"); 
memset(data,0,256); 
retval-read(fd,data,255); 
if(retval—-1) 
{ 
perror("read error\n"); 
exit(-1); 
} 
printf("%s\n",data); 
close(fd); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter drivers | insmod demo.ko 
&g seqfile-bf020664 
&sr-^list[(0]-c6ed6a60 
&sr-^list[1]-c6ed6c00 
&sr-»list[2]-c6ed6660 
&sr-^list[3]-c6ed6700 

initfind the 1 list element 

initfind the 2 list element 

initfind the 3 list element 

initfind the 4 list element 

[root(Q)urbetter drivers]|£ mknod /dev/fgj c 224 0 
[root(a)urbetter drivers |? ./test 

open /dev/fgj successfullysimple seq start *pos-c6ed6700 
simple seq show 1 

simple seq next *pos-c6ed6700 
simple seq show 2 

simple seq next *pos-c6ed6660 
simple seq show 3 

simple seq next *pos-c6ed6c00 
simple seq show 4 

simple seq next *pos-c6ed6a60 
simple seq stop 


name: Srl, iflag:1 

name: sr2, iflag:2 

name: sr3, iflag:3 

name: sr4, iflag:4 

/当然 也 可 以 直接 用 cat 显示 文件 内 容 
[root@urbetter drivers]? cat /dev/fgj 
simple seq start *pos=c6ed6700 


simple seq show 1 
simple seq next *pos-c6ed6700 
simple seq show 2 
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simple seq next *pos=c6ed6660 
simple seq show 3 
simple seq next *pos-c6ed6c00 
simple seq show 4 
simple seq next *pos-c6ed6a60 
simple seq stop 
simple seq start *pos-bf020664 
simple seq stop 

name: srl, iflag:1 

name: sr2, iflag:2 

name: sr3, iflag:3 

name: sr4, iflag:4 
[root(a)urbetter drivers |? 


(511.11 seq file 集中 输出 方式 实例 


下 面 以 linux 内 核 中 的 /fs/proc/cpuinfo.c 代码 为 例 说 明 seq file 集中 输出 方式 。 关 于 proc 
文件 系统 ， 下 一 节 会 介绍 相关 接口 。 首 先 注册 /proc/cpuinfo 节点 : 


static int — init proc cpuinfo init(void) 


1 


proc create("cpuinfo", 0, NULL, &proc cpuinfo operations); 
return 0; 


j 


fs initcall(proc cpuinfo init); 
定义 proc cpuinfo operations: 


static const struct file operations proc cpuinfo operations = { 


.open — cpuinfo open, 
read — seq read, 
.llseek = seq lseek, 
release — seq release, 


h 
接 下 来 看 cpuinfo open: 


extern const struct seq operations cpuinfo op; 
static int cpuinfo open(struct inode *inode, struct file *file) 


1 
return seq open(file, &cpuinfo op); 


j 


每 种 硬件 平台 都 会 实现 自己 的 cpuinfo op 操作 结构 。ARM 的 cpuinfo op 在 /arc/arm/ 
kernel/setup.c 中 : 


const struct seq operations cpuinfo op={ 
start = c start, 
.next = c next, 


.Stop —c stop, 
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34 


cpuinfo op 操作 接口 负责 输出 本 机 处 理 器 信息 到 /proc cpuinfo 文件 。 


.Show= c show 


li 


T 


static void *c start(struct seq file *m, loff t *pos) 


1 
return *pos « 1 ? (void *)1 : NULL; 
} 
static void *c next(struct seq file *m, void *v, loff t *pos) 
1 
++*pos; 
return NULL; 
j 
static void c stop(struct seq file *m, void *v) 
1 
} 


/在 show 函数 中 显示 所 有 内 容 
static int c show(struct seq file *m, void *v) 


1 


int i, j; 

u32 cpuid; 

for each online cpu(i) {// 裔 历 每 个 处 理 器 
seq printf(m, "processor\t: %d\n", 1); 


cpuid — is smp() ? per cpu(cpu data, 1).cpuid : read cpuid 1d(); 
seq printf(m, "model name: 96s rev %d (Vos)n",cpu name, cpuid & 15, elf platform); 
#if defined(CONFIG. SMP) 
seq printf(m, "BogoMIPS\t: %lu.%02lu\n", 
per cpu(cpu data, i).loops per jiffy / (500000UL/H2), 
(per cpu(cpu data, 1).loops per jiffy / (5000UL/H2)) % 100); 


#else 
seq printf(m, "BogoMIPS\t: %lu.%02lu\n", 
loops per jiffy / (500000/HZ), 
(loops per jiffy / (5000/HZ)) % 100); 
#endif 


JFT EP AEREAS ARE PES 
seq_puts(m, "Features\t: "); 
for (j = 0; hwcap _str[j]; j++) 
if (elf hwcap & (1 << j)) 
seq printf(m, "96s ", hwcap str[j]); 
for (j = 0; hwcap2 str[j]; j++) 
if (elf hwcap2 & (1 «« j)) 
seq printf(m, "%s ", hwcap2 str[j]); 
seq printf(m, ^nCPU implementerV: 0x%02x\n", cpuid >> 24); 


seq printf(m, "CPU architecture: %s\n", 
proc arch[cpu architecture()]); 


第 1 章 Linux 设备 驱动 程序 入 门 


if ((cpuid & 0x0008f000) == 0x00000000) { 
/* pre-ARM7 */ 
seq printf(m, "CPU partit: 9607x Wn", cpuid >> 4); 
} else ( 
if ((cpuid & 0x0008f000) == 0x00007000) { 
/* ARM7 */ 
seq printf(m, "CPU variant\t: 0x2902x n", (cpuid >> 16) & 127); 
} else ( 
/* post-ARM7 */ 
seq printf(m, "CPU variant\t: 0x%x\n", (cpuid >> 20) & 15); 
j 
seq printf(m, "CPU part\t: 0x9903x Wn", (cpuid >> 4) & Oxfff); 
j 
seq printf(m, "CPU revision\t: %d\n\n", cpuid & 15); 
j 
seq printf(m, "HardwareW: Vos", machine name); 
seq printf(m, "RevisionX: %04x\n", system rev); 
seq printf(m, "Serial\t\t: %s\n", system. serial); 
return 0; 


j 
上 面 代码 的 运行 结果 如 下 : 


[root@urbetter proc] cat cpuinfo 


processor :0 

model name : ARMv6-compatible processor rev 6 (v6l) 
BogoMIPS : 528.79 

Features : half thumb fastmult vfp edsp java tls 


CPU implementer : 0x41 
CPU architecture : 7 


CPU variant : 0x0 

CPU part : 0xb76 

CPU revision :6 

Hardware : SMDK6410 
Revision : 0000 

Serial : 0000000000000000 


1.4 /proc 文件 系统 


1.4.1 /proc 文件 系统 概述 

Linux 内 核 中 的 /proc 文件 系统 是 一 种 特殊 的 文件 系统 ， 通 过 它 可 以 在 运行 时 访问 内 核 的 
内 部 数据 结构 、 改 变 内 核 设 置 ， 内 核 可 以 通过 它 癌 进程 发 送信 息 。 应 用 程序 可 以 通过 /proc 
文件 系统 获取 有 关 进 程 的 有 用 信息 ，Linux 中 的 ps. top 命令 就 是 通过 读 取 /proc 下 的 文件 来 
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T 
的 任 


信息 


通过 


获取 它们 需要 的 信息 。 与 
内 存 中 而 不 是 硬盘 或 其 他 存储 设备 上 
何 一 个 进程 来 说 ， 在 proc 的 子 
获取 进程 信息 、 电 源 管 理 CAPM) 
内 存 信息 (meminfo ) 455. /proc 目录 下 的 核心 文件 


他 文件 系统 


\ 同 ，/proc 主要 存放 | 
Eo /proc 文件 系统 的 模 


[root@urbetter proc]# ls 


1 

1027 
1030 
1033 
1036 
1039 
1042 
1045 
1048 
1051 
1052 
1053 
1054 
1055 
1056 
1057 
1058 
1059 
1060 
1061 
1062 
1063 
1064 
1065 
1066 
1112 
1117 


上 面 信息 的 左边 三 列 数字 都 是 


o 


1122 
1127 
113 

1141 
1154 
1179 
1192 
1195 
1196 
1197 
1220 
1223 
1230 
1231 
1232 
1233 
1242 
197 


录 里 都 有 


993 


asound 


proc 文件 系统 一 般 是 自动 加 载 上 
过 如 下 命令 加 载 proc 文件 系统 : 


mount 


-t proc proc /proc 


1.4.2 /proc 文件 系统 接口 
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/proc 文件 


系统 的 条 目 用 proc dir entry 结构 描 


struct proc dir entry ( 


Ho 


个 同名 的 进程 ID。 


结构 如 下 : 


buddyinfo 
bus 
cmdline 
consoles 
cpu 
cpuinfo 
crypto 
devices 
diskstats 
driver 
execdomains 
fb 
filesystems 
fs 
interrupts 
iomem 
ioports 

irq 
kallsyms 
key-users 
keys 

kmsg 
kpagecount 
kpageflags 
loadavg 
locks 


meminfo 


I 核 控 制 的 状态 信息 ， 它 存 
录 就 是 /proc。 对 于 系统 中 


利用 /proc 文件 系统 可 以 
HA. CPU 信息 (cpuinfo)、 负 载 信息 C(loadavg). AZ 


misc 
modules 
mounts 

mtd 

net 
pagetypeinfo 
partitions 
sched debug 
Scsi 

self 

slabinfo 
softirqs 

stat 

swaps 

Sys 
Sysrq-trigger 
thread-self 
timer list 

tty 

uptime 
version 
vmallocinfo 
vmstat 


zoneinfo 


如 果 系 统 局 动 时 没有 自动 加 载 proc 文件 


录 ， 对 应 于 进程 ID 号 ， 这 些 目录 对 应 的 是 某 个 进程 的 


系统 ， 可 以 
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unsigned int low ino; 


umode t mode; 


nlink t nlink; 

kuid t uid; /用 户 
kgid t gid; /用 户 组 
loff t size; 


conststructinode operations *proc iops; /节点 操作 


const struct file operations *proc fops; /文件 操作 
struct proc dir entry *parent; / 父 路 径 


struct rb root subdir; 

struct rb node subdir node; 

void *data; 

atomic t count; Pf FB v EACUS 

atomic tin use; ”/* 当前 调用 者 数量 */ 
struct completion *pde unload completion; 


struct list head pde openers; /* who did ->open, but not ->release */ 
spinlock t pde unload lock; /* proc fops checks and pde users bumps */ 
u8 namelen; 


char name[]; 


以 下 是 内 核 提 供 的 几 个 重要 的 /proc 文件 系统 接口 函数 。 
1) proc mkdir 


struct proc dir entry *proc mkdir(const char *name,struct proc dir entry *parent); 


该 函数 


于 创建 一 个 proc 目录 ， 参 数 name 指定 要 创建 的 proc 目录 的 名 称 ， 参 数 parent 


为 该 proc 


目录 所 在 的 目录 。 


2) proc create 


struct proc dir entry *proc create(const char *name, umode t mode, struct proc dir entry *parent, 


const struct file operations *proc fops); 


TI 


proc create 函数 用 来 创建 proc 条 目 。 其 中 name 为 文件 名 称 。mode 为 文件 权限 。parent 


为 文件 的 父 


目录 的 指针 ， 它 为 null 时 表示 父 目 录 为 /proc。 


3) proc create data 


struct proc dir entry *proc create data(const char *name, umode t mode, 


struct proc dir entry *parent,const struct file operations *proc fops,void *data); 


proc create data 函数 只 比 proc create 函数 多 了 一 个 data 参数 ， 用 于 填充 proc dir entry 
结构 的 data 成 员 。 


4) proc remove 


void proc remove(struct proc dir entry *de); 


proc remove 函数 用 于 删除 de 指向 的 proc % H « 


] 
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5) remove proc entry 


void remove proc entry(const char *name, struct proc dir entry *parent); 


remove proc entry 函数 用 于 删除 parent 目录 下 名 为 name 的 proc 条 


表示 父 目 录 为 /proc。 


例 1.12 /proc 文件 系统 驱动 程序 实例 


下 面 的 例子 演示 了 如 何 创 建 /proc 文件 系统 的 节点 ， 并 对 


\samples\1door\1-9proc。 核 心 代码 如 下 : 


static const struct file operations proc simple fops={ 


Ds 


.owner = THIS MODULE, 
write = simple write, 
read — seq read, 

.open = simple proc open, 
release — single release, 


int init simple module( void ) 


1 


j 


int ret = 0; 
simple buffer — (char *)vmalloc( MAX simple LENGTH ); 
if(!simple buffer) 


1 
ret --ENOMEM; 
} 
else 
{ 
memset( simple buffer, 0, MAX LENGTH ); 
proc entry-proc mkdir("demo", NULL); 
proc status = proc create("status", 0,proc entry,&proc simple fops); 
if (!proc status) 
1 
ret = -ENOMEM; 
vfree(simple buffer); 
printk(KERN INFO "demo: Couldn't create proc entry n"); 
} 
else 
{ 
printk(KERN INFO "demo: Module loaded.\n"); 
} 
} 
return ret; 


void cleanup simple module( void ) 


{ 
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进行 读 写 操作 。 具 体 代码 见 
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proc remove(proc entry); 

vfree(simple buffer); 

printk(KERN INFO "demo: Module unloaded. n"); 
j 


对 于 简单 的 顺序 输出 ， 不 需要 提供 很 复杂 的 seq file 实现 ， 可 以 只 提供 show 函数 ， 这 
时 候 single open 就 派 上 用 场 了 。 以 下 是 打开 操作 的 实现 : 


static int simple proc open(struct inode *inode, struct file *file) 


1 
return single open(file, simple show, inode-^i private); 


j 
以 下 是 读 操作 的 实现 ， 它 实现 了 打印 系统 当前 进程 信息 的 功能 。 


static int simple show(struct seq file *file, void *iter) 
{ 
struct task_struct *p; 
char state; 
seq printf(file, "%5s%7s%7s%7s%7s%7s%7s %s\n\n", 
"PID","UID","PRIO","POLICY","STATE","UTIME","STIME","COMMAND"); 
for each process(p) {// 遍 历 进 程 
int pid = p->pid; 


if (unlikely(!pid))continue; 
switch((int)p-^state) 
{ 
case -1: state='Z'; break; 
case 0: state='R'; break; 
default: state='S'; break; 
j 
seq printf(file, "%5Sd%7d%7d%7d%7c%7d%7d — %s\n", 
(int)p-7pid, (int)p-^tgid, (int)p-^rt priority, 
(int)p-7policy,state, (int)p-^utime, (int)p-^stime,p-^»comm); 
j 
return 0; 


j 
以 下 是 写 操作 的 实现 代码 ; 


Ssize t simple write( struct file *flip, const char — user *buff, size t len, loff t *offset) 
1 

ilen>MAX LENGTH)len-MAX LENGTH; 

if(copy from user(simple buffer, buff, len )) 

1 

return -EFAULT; 

j 

simple buffer[len] — 0; 

printk(KERN INFO "simple write: %s\n",simple buffer); 
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return len; 


j 


本 例 运 行 结果 如 下 : 


第 2 版 


[root@urbetter drivers | insmod demo.ko 
demo: Module loaded. 
[root(Q)urbetter drivers |? cat /proc/demo/status 


PID 


co —-1 0 tn 4 t2 h2 一 


O 
- 


204 
206 
207 
209 
224 
225 
367 
375 
440 
1002 
1165 
1178 
1246 
1249 
1256 
1257 
1258 
1259 
1278 


UID 


co —-1 0 tn ODO- 


o 
-1 


204 
206 
207 
209 
224 
DS 
367 
S 
440 
1002 
1165 
1178 
1246 
1249 
1256 
1257 
1258 
1259 
1278 


PRIO POLICY STATE UTIME STI 


(c3. ex 4e3 m3. (X3. (3 05. €». (63  €3 (e3 4€3 de39 (m. (3. (03. €. 03 €». € 


un 
© 


S €» OSD  (e3 OO 


0 


0 


moe e SO Bo e (3 6X3 0€ G ONO (63. (09 de. (£5 


0 


S 


ua uwnuwuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuudu 


R 


11 


Em 
h 


3 


0 


[root@urbetter drivers]? echo "fgj">/proc/demo/status 


simple write: fgj 


1.5 Linux 内 核 


1 去 
TE 


1.5.1 Linux 内 核 组 成 


Linux 内 核 主要 由 五 个 部 分 组 成 : 进程 调度 、 内 存 
管理 。 图 1-5 为 Linux 内 核 的 架构 原理 
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9 


OO 


init 

kthreadd 
ksoftirqd/0 
kworker/0:0 
kworker/0:0H 
kworker/u2:0 
netns 
kworker/u2:1 
kworker/u2:2 
writeback 
crypto 

bioset 
kblockd 
cfg80211 
kworker/0:1 
rpciod 
kswapd0 
nfsiod 

bioset 
kpsmoused 
irq/88-mmcO 
syslogd 

inetd 

sh 

init 

init 

init 


cat 


y 


ME COMMAND 


m 


H 


理 、 文 件 系 统 、 网 络 子 系统 、 设 备 


， 可 见 应 用 | 


:通过 系统 调 


访问 Linux 内 核 ， 而 


Linux 内 核 通 过 设备 驱动 来 访问 各 种 硬件 设备 。 


用 户 空 间 ”应 用 程序 


进程 调度 


Linux 内 核 


体系 相关 代码 


(1) 进程 调度 


系统 调用 


内 存 管理 


^A -> 
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设备 管理 
字符 设备 驱动 块 设备 驱动 网 络 设备 驱动 


总 线 


各 种 硬件 CPU RAM FLASH SATA 


KI 


1-5 Linux 内 核 架 构 原 理 


(Process Schedule): Linux 支持 多 任务 与 多 进程 ， 


网 卡 


Linux 内 核 调 度 器 基于 


优先 级 可 动态 调整 的 进程 调度 器 。Linux 进程 的 通信 支持 系统 V 的 各 种 通信 机 制 。Linux 内 


核 从 2.6.23 版 本 开始 采 月 
务 提供 


处 理 器 时 间 方 面 的 公平 


里 进程 调度 。 


(2) 内 存 管理 (Memory Management): Linux [| 
分 页 机 制 。 内 存 管理 子 系统 允许 多 个 进程 安全 地 


支持 超过 实际 内 存 大 小 的 内 存 地 址 ， 人 磁盘 可 以 被 用 作 


嵌入 式 处 理 器 中 的 MMU 单元 就 是 用 来 实现 内 存 管理 


ti 


H CFS (Completely Fair Scheduler) 调度 器 。CFS 


的 主要 理念 是 为 任 


E， 确 保 每 个 任务 能 够 有 时 间 执 行 。CFS 采用 红 黑 树 思想 来 管 


的 内 存 管 理 支 持 虚 拟 内 存 ， 它 采取 的 是 
< 享 主 内 存 


区 域 。 通 过 内 存 管理 ，Linux 可 


MMU 单元 完成 的 。 


VFS). VFS 使 用 
一 的 接口 
(4) 设备 管理 (Device Management): Linux xF 


件 设 备 ， 并 提供 了 平台 设备 的 概念 与 sys Xf 


(3) 文件 系统 (Filesystem): Linux 内 核 支 持 多 种 文件 系统 ， 在 Linux 


内 存 ， 人 磁盘 与 内 存 之 间 可 
的 ， 虚 拟 地 址 到 物 


以 相互 交换 。 
里 地 址 的 映 财 就 是 由 


操作 系统 中 ， 用 


式 至 可 以 访问 Windows 系统 的 文件 ， 这 得 益 于 Linux 内 核 中 的 虚拟 文件 系统 〔 简 称 


个 通用 的 文件 模型 来 管理 不 同 的 文件 系统 ， 为 所 有 的 存 


o VFS 支持 的 文件 系统 包括 ext2、ext3、ext4、fat、jffs2、ubifs 等 ， 
字符 设备 、 块 设备 及 网 络 设备 三 类 硬 
系统 来 管理 各 种 设备 。Linux 的 设备 驱动 可 以 


嵌 设 备 提 供 了 统 
多 达 数 十 种 。 


编译 进 内 核 ， 在 系统 启动 时 加 载 ， 也 可 以 作为 模块 形式 动态 地 加 载 。 从 2.6 版 内 核 开始 ， 


Linux 提供 了 统 
设备 在 底层 都 


性 。Linux 网 络 子 系统 包括 
协议 ， 而 网 络 设备 驱动 程序 负责 与 物 


有 统一 的 接 
C5) 网 络 子 系统 (Network 


一 的 内 核 设备 模型 ， 


这 个 模型 


正 因为 Linux A 


理 网 卡通 信 。 在 应 用 


X 


JE] Ro 


强大 的 网 络 子 系统 ， 


的 最 高 层 抽象 为 Kobject， 这 个 数据 结构 使 所 有 


Subsystem): 对 网 络 协议 的 支持 从 一 开始 就 是 Linux 的 重要 特 
网 络 协议 部 分 与 网 络 驱动 程序 。 


网 络 协议 部 分 负责 实现 各 种 网 络 


目前 Linux 在 网 络 服务 器 、 交 换 与 路 | 


层 ，Linux 支持 网 络 套 接 字 接口 。 
设备 中 的 应 用 
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15.2 Linux 的 代码 结核 
Linux 代码 非常 庞大 ， 其 中 驱动 程序 约 占 一 半 。 表 1-2 列 出 了 Linux 内 核 代 码 的 重要 目录 。 


un 


1-2 Linux 内 核 代码 的 重要 目录 


H sx 说 明 
arch 硬件 平台 相关 代码 
block 块 设备 核心 代码 
crypto 加 密 函 数 库 
documentation 有 关内 核 各 个 部 分 的 通用 解释 和 注释 的 文本 文件 
drivers 设备 驱动 相关 代码 
fs 文件 系统 相关 代码 
include 核 头 文件 
init 内 核 初始 化 代码 
ipc System V 的 进程 间 通 信 
kernel 核 核 心 部 分 ， 进程 调度 、 中 断 处 理 、 信 号 处 理 、 模 块 
lib 通用 内 核 函数 
mm 内 存 管 理 
net 网 络 通信 协议 代码 
samples 内 核 例子 
security 系统 安全 相关 代码 
sound 音频 体系 代码 


Linux 内 核 中 与 硬件 体系 相关 的 文件 夹 包括 /arch 和 /include/asm-*， 具 体 如 下 : 

e arch Hox: 包含 和 硬件 体系 结构 相关 的 代码 ， 每 种 平台 对 应 一 个 相应 的 目录 。 和 32 
位 PC 相关 的 代码 存放 在 386 目录 下 ， 其 中 比较 重要 的 包括 kermel (内 核 核 心 部 
分 )、mm (内 存 管理 )、math-emu( 浮 点 单元 仿真 ;)、lib 〈 硬 件 相 关 工具 函数 )、boot 
(引导 程序 )、pci (PCI 总 线 ) 和 power CCPU 相关 状态 )。 

e include/asm-*: include 子 目 录 包 括 编译 内 核 所 需要 的 大 部 分 头 文件 。 与 平台 无 关 的 头 
文件 在 include/linux 子 目 录 下 ， 与 体系 相关 的 头 文 件 在 include/asm-* 子 目录 下 ， 而 
include/scsi 目录 则 是 有 关 scsi 设备 的 头 文件 目录 。 

编译 内 核 的 几 个 命令 如 下 所 示 : 


#make menuconfig /配置 内 核 命令 
# make /编译 生成 目标 文件 ， 包 括 可 加 载 模块 
# make zImage // 编 译 生 成 内 核 


# make modules install /安装 模块 


当 需 要 将 模块 安装 到 非 默认 位 置 的 时 候 ， 可 以 使 用 INSTALL MOD PATH 指定 一 个 前 
28, 例如 : 


#make INSTALL MOD PATH=/foo modules install 
运行 这 个 命令 后 模块 将 被 安装 到 /foo/lib/modules 目录 下 。 
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Linux 内 核 的 Makefile 分 为 4 个 组 成 部 分 : 
(1) 顶层 Makefile: 在 内 核 代码 最 顶层 。 顶 层 的 Makefile 文件 读 取 .config 文件 的 内 


容 ， 并 总 体 


信息 。Scripts 


定义 和 规则 。 


(2) config 配置 文 伯 
(3) Makefi 
(4) kbuild Makefile 文件 : 
kbuild Makefile 的 语法 结构 
1) 目标 定义 

目标 定义 就 是 用 来 定义 哪些 内 容 要 作为 模块 编译 ， 哪 些 内 容 要 编译 链接 进 内 核 。 例 如 ; 


obj-y += foo.o 


Dd 


的 配置 文 伯 


在 各 级 


已 表示 要 1 


-负责 build 内 核 和 模块 。arch 目录 的 Makefile 提供 了 硬件 体系 结构 相关 的 编译 
目录 下 的 Makefile 文件 包含 了 所 有 用 来 根据 kbuild Makefile 构建 内 核 所 需 的 


FF ， 一 般 在 /arch/*/configs 下 面 。 
: 在 scripts/ 目 录 下 的 Makefile.* 文 件 中 。 
目录 下 面 。 

E 常 简单 ， 主 要 包括 以 下 儿 点 核心 内 容 : 


foo.c 或 者 foo.s 文件 编译 得 到 foo.o 并 链接 进 内 核 。 如 果 使 用 $(obj-m) 则 表示 


对 象 文件 编译 成 可 加 载 的 内 核 模块 。kbuild Makefile 文件 中 的 目标 通常 是 下 面 的 形式 : 


obj-$(CONFIG I2C BOARDINFO)+= i2c-boardinfo.o 
obj-$(CONFIG IC)+= i2c-core.o 
obj-$(CONFIG I2C CHARDEV) += i2c-dev.o 


上 面 的 语句 
20 多 文 伯 
如 果 一 个 模块 
模块 的 组 成 文 


obj-$(CONFIG_FB) += fb.o 


FHR WKH 


fb-y:= fbmem.o fbmon.o fbcmap.o fbsysfs.o ^ 


fb-objs:= $(fb-y) 


fbcvt.o 等 文人 , 
3) 目录 迭代 


录 和 迭代 是 将 目标 依赖 的 文 从 


[指向 另 一 个 


obj-$(CONFIG FB OMAP) += omap/ 


如 果 CONFIG FB OMAP 的 值 为 y 或 m, kbuild 会 将 omap 目录 列 入 向 下 迭代 的 目标 


中 ， 但 是 其 作用 也 仅 限 于 此 ， 至 于 
还 要 由 omap 目录 下 的 Makefile 文 从 


诉 编译 器 编译 选项 对 应 的 目标 文件 。 


模块 名 加 —objs 后 级 或 者 -y 后 级 的 形式 来 定义 


上 例 中 目标 模块 名 为 也 ， 它 依赖 于 fomem.o. fbmon.o. fbemap.o. fbsysfs.o. modedb.o. 
这 些 文件 最 终 链 接生 成 fb.ko 文件 。 上 面 的 斜 杠 \ 表 示 换 行 。 


Ha. 


omap 目录 下 的 文件 是 要 作为 模块 编译 还 是 链接 入 内 核 ， 
F 的 内 容 来 决定 。 
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自 Linux 2.6 起 ，Linux 内 核 采 用 了 全 新 的 设备 管理 模型 ， 它 基于 sysfs XH 


系统 ， 将 系 


统 中 的 设备 组 织 成 层次 结构 ， 方 便 用 户 查 询 设备 信息 ， 并 对 设备 进行 控制 。 该 模型 在 智能 电 
源 管理 、 热 插 拔 以 及 与 用 户 空间 交互 等 方面 具有 明显 的 优势 。 本 半 主 要 介绍 Linux 内 核 中 的 


驱动 程序 模型 、sysfs 文件 系统 、 平 台 设 备 模 型 、 设 备 树 等 内 容 。 


2.1 内 核对 象 


2.1.1 kobject 


kobject〈 内核 对象) 是 Linux 内 核 设备 管理 机 制 的 最 高 层 抽象 。kobject 类 似 面向 对 象 体 
系 中 的 基 类 ， 它 往往 被 嵌入 到 其 他 结构 体 中 ， 形 成 一 个 复杂 的 多 层次 结构 。kobject 本 身 对 应 


着 sysfs 文件 系统 中 的 一 个 目录 。kobject 还 负责 设备 热 插 拔 等 事件 的 处 理工 作 。 
定义 如 下 : 


struct kobject { 
const char — *name; // 名 称 
struct list head entry; 
struct kobject *parent; // 父 对 象 
struct kset *kset; /所 属 的 kset 
struct kobj type *ktype; // 对 象 的 类 型 
struct kernfs node *sd;  /*sysfs 目录 项 */ 
struct kref kref; // 引用 计数 
#ifdef CONFIG DEBUG KOBJECT RELEASE 
struct delayed work release; 
#endif 


unsigned int state initialized:1; 


unsigned int state in sysfs:1; 

unsigned int state add uevent sent:1; 

unsigned int state remove uevent sent:1; 

unsigned int uevent suppress:1;// 是 否 发 送 uevent 事件 
h 


kobject 对 象 的 接口 函数 如 下 : 


void kobject init(struct kobject *kobj, struct kobj type *ktype);// 初 始 化 kobject 


kobject 结构 


int kobject add(struct kobject *kobj, struct kobject *parent,const char *fmt, ...);// 将 kobject 加 入 到 系统 


/上 面 两 个 函数 的 结合 


int kobject init and add(struct kobject *kobj,struct kobj type *ktype, struct kobject *parent,const char 
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*fmt, ...); 
void kobject del(struct kobject *kobj); /将 kobject 从 系统 中 删除 
struct kobject * kobject create(void); 
struct kobject * kobject create and add(const char *name,struct kobject *parent); 
struct kobject *kobject get(struct kobject *kobj); /增加 对 象 引 用 次 数 
void kobject put(struct kobject *kobj); /减少 对 象 引用 次 数 


内 核 中 常见 的 kobject 包括 : 


static struct kobject *dev kobj; /设备 对 象 

struct kobject *sysfs dev char kobj; /字符 设备 对 象 

struct kobject *sysfs dev block kobj; // 块 设备 对 象 

struct kobject *kernel kobj; //sysfs 下 的 kernel 对 象 


2.1.2 kobj type 


kobj type 表示 内 核对 象 的 类 型 ; 


struct kobj type { 
void (*release)(struct kobject *kobj); 
const struct sysfs ops *sysfs ops;  //sysfs 操作 
struct attribute **default attrs; /默认 属 ; 
const struct kobj ns type operations *(*child ns type)(struct kobject *kobj); 
const void *(*namespace)(struct kobject *kobj); 


H 
sysfs ops 为 内 核对 象 在 sysfs 文件 系统 中 的 操作 接口 : 


struct sysfs ops { 


ssize t (*show)(struct kobject *, struct attribute *, char *); /显示 
ssize t (*store)(struct kobject *, struct attribute *, const char *, size t); /存储 
} 

2.1.3 kset 


kobject 通过 kset 组 织 成 层次 化 的 结构 ，kset 是 具有 相同 类 型 的 kobject WRES. MAF 
于 同一 个 kset 的 对 象 (kobjecb 的 parent 都 指向 该 kset 的 kobj 成 员 。 


Pn 


struct kset { 


struct list head list; // 同 一 kset 的 链表 

spinlock tlist lock; // 锁 

struct kobject kobj; // 自 身 的 kobject 

struct kset uevent ops *uevent ops; // uevent 相关 操作 ,如 事件 过 滤 等 


上 
kset 对 象 的 接口 函数 如 下 : 


void kset init(struct kset * k); 
struct kset * kset create and add(const char *name,struct kset uevent ops *u,struct kobject *parent kobj); 
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int kset register(struct kset *kset); 
void kset unregister(struct kset *kset); 


内 核 中 常见 的 kset 包括 : 


struct kset *bus kset; 
struct kset *class kset; 
struct kset *system kset; 


2.0 设备 模型 层次 


Linux 内 核 的 设备 模型 包括 设备 (device)、 设 备 驱 动 (device_driver)、 总 线 (bus)、 设 备 类 
(class) 等 几 个 核心 组 件 。 

device 代表 一 个 设备 ， 设 备 结构 (struct device) 中 包含 了 设备 的 DMA 设置 以 及 与 体系 
相关 的 硬件 特性 ， 具 体 定义 如 下 : 


struct device { 


struct device *parent; // 父 设备 

struct device private *p; 

struct kobject kobj; /关联 的 内 核对 象 

const char "init name; —/*48J 44K 

const struct device type *type; 

struct mutex mutex; UEFE 

struct bus_type *bus; PRR TERI ARE 

struct device driver *driver; PISA driver*/ 

void *platform data; EFR RRA 

void *driver data; /驱动 数据 ， 设 置 /获取 方法 为 dev_set/get_drvdata*/ 

struct dev pm info power; 

struct dev pm domain *pm domain; 
#ifdef CONFIG NUMA 

int numa node; PCASAKIXIT] NUMA 节点 */ 
#endif 

u64 *dma mask; /*dma 扒 码 */ 

u64 coherent dma mask; /一 致 性 DMA 捧 码 

unsigned long dma pfn offset; 

struct device dma parameters *dma parms; //DMA 参数 

struct list head dma pools; /*DMA 池 */ 

struct dma coherent mem *dma mem;  //DMA 内 存 

庶 体 系 相 关 的 成 员 */ 

struct dev archdata archdata; 

struct device node *of node; 放 关 联 设 备 树 节点 */ 

struct fwnode handle*fwnode; AEA T naut 

dev t devt; /*dev t, creates the sysfs "dev" */ 

u32 id; 此 设备 ID*/ 

spinlock t devres lock; 

struct list head devres head; 
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knode class; 


*class; 


struct klist node 
struct class 


const struct attribute group **groups; 
void (*release)(struct device *dev); 
struct iommu group *iommu group; 
bool offline disabled:1; 
bool offline:1; 


5 
device 的 注册 与 注销 函数 如 下 : 


int device register(struct device * dev); 
void device unregister(struct device * dev); 
int device add(struct device * dev); 


void device del(struct device * dev); 


/设备 类 
/* EEH S 


A -> 
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device driver 即 设备 的 驱动 ， 它 对 应 的 数据 结构 定义 如 下 : 


struct device driver { 


const char  *name; /设备 驱动 程序 的 名 称 
struct bus type *bus; // 挂 接 的 总 线 

struct module*owner; 

const char —*mod name; 旋 用 于 内 置 模块 */ 


bool suppress bind attrs; 
enum probe type probe type; 
*of match table; 


*acpi match table; 


const struct of device id 
const struct acpi device id 


int (*probe) (struct device *dev); 


[* 75 | 3i E. sysf 绑 定 / 解 绑 头 


// 指 向 设备 探测 函数 


int (*remove) (struct device *dev); /用 于 删除 设备 的 函数 

void (*shutdown) (struct device *dev); /停止 设备 的 函数 

int (*suspend) (struct device *dev, pm message t state); // 挂 起 设备 的 函数 
int (*resume) (struct device *dev); /恢复 设备 的 函数 


const struct attribute group **groups; 
const struct dev pm ops *pm; 
struct driver private *p; 


5 
device driver 的 注册 与 注销 函数 原型 如 下 : 


int driver register(struct device driver * drv); 
void driver unregister(struct device driver * drv); 


probe 成 员 函 数 在 Linux 驱动 开发 中 是 一 个 很 重要 的 接 


系 ， 可 发 现 driver register->bus add driver-> driver attach-> 


。 分 析 driver register 函数 的 调用 关 


driver attach-> driver probe device-> 


really probe: 


static int really probe(struct device *dev, struct device driver *drv) 


1 
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if (dev->bus->probe) 1 
ret = dev-»bus-»probe(dev); 
if (ret) 
goto probe failed; 
} else if (drv-^probe) 1 
ret = drv-»probe(dev); 
if (ret) 
goto probe failed; 


j 
} 
假如 设备 的 总 线 没有 实现 probe 成 员 函 数 ， 则 driver register 函数 会 调用 device driver 
的 probe 成 员 函 数 。 
设备 与 设备 驱动 均 挂 载 到 总 线 上 ， 总 线 完 成 设备 、 设 备 驱动 的 匹配 、 探 测 等 管理 工作 。 


struct bus type { 


const char *name; 
const char *dev name; 
struct device *dev root; 


const struct attribute group **bus groups; 

const struct attribute group **dev groups; 

const struct attribute group **drv groups; 

int (*match)(struct device *dev, struct device driver *drv);/ 匹 配 设 备 与 驱动 
int (*uevent)(struct device *dev, struct kobj uevent env *env); 

int (*probe)(struct device *dev); 

int (*remove)(struct device *dev); 

void (*shutdown)(struct device *dev); 

int (*suspend)(struct device *dev, pm message t state); 

int (*resume)(struct device *dev); 


js 
类 是 对 设备 的 更 高 级 的 抽象 ， 它 更 关注 设备 的 共性 : 


struct class { 


const char *name; 
struct module *owner; 
struct class attribute *class_attrs;// 类 属性 


const struct attribute group **deyv groups; 

struct kobject*dev kobj; 

int (*dev uevent)(struct device *dev, struct kobj uevent env *env); 
char *(*devnode)(struct device *dev, umode t *mode); 

void (*class release)(struct class *class); 

void (*dev release)(struct device *dev); 

int (*suspend)(struct device *dev, pm message t state); 

int (*resume)(struct device *dev); 

const struct kobj ns type operations *ns type; 
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const void *(*namespace)(struct device *dev); 
const struct dev pm ops *pm; 
struct subsys private *p; 


je 
使 用 class create 可 以 创建 一 个 类 。 系 统 注册 的 类 可 以 在 /sysfs/class 目录 下 面 找到 。 


#define class create(owner, name) \ 
G N 
static struct lock class key key; \ 
. class create(owner, name, & . key); \ 


3) 


void class destroy(struct class *cls); 


2.3 sysfs 文件 系统 


sysfs 是 一 个 特殊 的 文件 系统 ， 类 似 于 /proc。sysfs 不 仅 像 proc 一 样 允许 用 户 空 间 访 问 内 
核 的 数据 ， 而 且 以 更 结构 化 的 方式 向 用 户 提供 内 核 数 据 信 息 。sysfs 是 一 种 内 存 文件 系统 ， 它 
与 kobject 关系 非常 密切 。 系 统 中 的 每 一 个 kobject 对 应 着 sysfs 
中 的 一 个 目录 ， 而 每 一 个 sysfs 中 的 目录 代表 一 个 kobject 对 表 2-1 sysf 文件 系统 的 目录 
象 ， 每 个 sysf 文件 代表 对 应 的 kobject 的 属性 。 


E 


名 称 说 明 
sysfs 文件 系统 非常 清晰 地 展示 了 设备 驱动 程序 模型 中 各 组 E Pis 
OC! Tx 
件 的 层次 关系 。 其 顶级 目录 包括 block. device. bus. drivers. 
US I £X, 
LA 
class. power. firmware 55. ER "T 
[root(Qyurbetter sys]? ls devices 设备 
block class devices fs module firmware 固件 
bus dev firmware kernel power kernel 内 核 
defe dul mm 
/sys 的 根 目录 见 表 2-1。 SH: LASER 
电源 
sysfs 文件 系统 最 基本 的 函数 包括 : ————— 
int sysfs create file(struct kobject * kobj, const struct attribute * attr) ; /创建 文件 
int sysfs chmod file(struct kobject *kobj, struct attribute *attr, mode t mode); /修改 文件 属性 
void sysfs remove file(struct kobject * kobj, const struct attribute * attr); /删除 文件 
int sysf create dir ns(struct kobject *kobj, const void *ns); /创建 目录 
void sysfs remove dir(struct kobject *kobj); // 删 除 目 录 
intsysfs create group(struct kobject *kobj,const struct attribute group *grp); // 创 建 一 组 属性 
sysfs 文件 系统 一 般 是 自动 加 载 到 /sys 下 的 ， 也 可 以 通过 下 面 的 命令 手工 加 载 : 


mount -tsysfs sysfs /sys 


device create 函数 用 于 在 /sysfs 文件 系统 中 创建 一 个 指定 设备 号 的 设备 : 


struct device *device create(struct class *class, struct device *parent, 
dev t devt, void *drvdata, const char *fmt, ...); 
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4v 


例 2.1 


A 


本 例 演示 如 何在 驱动 中 创建 /sys 类 节点 与 /dev 设备 节点 。 先 要 在 /sys/class 目录 
内 核 事 件 ， 才 能 触发 udev 或 者 mdev 等 设备 事件 处 理 程序 来 增删 设备 节点 。 


自动 创建 设备 节点 


本 例 代 人 码 见 \samples\2model\2-1module_ devicecreate。 核 心 代 码 如 下 : 


static vold simple register (void) 


1 


j 


int error, devno - MKDEV (simple major, simple minor); 
cdev init (&cdev, &simple fops); 
cdev.owner = THIS MODULE; 
cdev.ops = &simple fops; 
error = cdev add (&cdev, devno , 1); 
if (error) 

printk (KERN NOTICE "cdev add error %d", error); 
/创建 simple class 
simple class =class_create(THIS MODULE, "simple class"); 
if(IS ERR(simple class)) { 

printk("Err: failed in creating class. n"); 


return ; 


j 
/在 simple class 下 创建 设备 
device create(simple classNULL, devno, NULL,"simple"); 


static int — init simple init (void) 


1 


j 


int result; 

dev = MKDEV (simple major, simple minor); 

result = register chrdev region (dev, number of devices, "simple"); 

if (result«0) 1 
printk (KERN WARNING "hello: can't get major number %d\n", simple major); 
return result; 

j 

simple register(); 

printk (KERN INFO "char device registered n"); 

return 0; 


static void — exit simple exit (void) 


1 


j 


dev t devno - MKDEV (simple major, simple minor); 
cdev del (&cdev); 

unregister chrdev region (devno, number of devices); 
device destroy(simple class, devno); 

class destroy(simple class); 


本 例 运行 结果 如 下 : 


50 


第 2 章 Linx 设备 驱动 模型 


[root@urbetter drivers | insmod smodule.ko 
char device registered 

[root@urbetter drivers] ls /dev | grep sim 
simple 

[root(Q)urbetter drivers] cd /sys/class 
[root(a)urbetter class [7 ls 


backlight hwmon mem rtc simple class 
bdi 12c-adapter misc Scsi device sound 

block i2c-dev mmc host Scsi disk spi master 
dma input mtd Scsi generic tty 

graphics led net Scsi host ubi 


[root(Qurbetter class |? cd simple class/ 
[root(Qurbetter simple class] ls 

simple 

[root(Q)urbetter simple class]£ cd simple/ 
[root(a)urbetter simple] ls 

dev power subsystem | uevent 
[root(Q)urbetter simple | rmmod smodule 
[root@urbetter simple]? Is /dev | grep sim 
[root@urbetter simple] 


可 见 /sys/class 以 及 /dev 下 面 均 创 建 了 设备 文件 。 


2.4 platform 概念 


struct bus type platform bus type - ( 


.name — "platform", 

.dev groups — platform dev groups, 
match — platform match, 

.uevent — platform uevent, 

.pm = &platform dev pm ops, 


js 


平台 设备 使 用 platform device 结构 描述 ， 该 结构 定义 如 下 : 


struct platform device { 
const char *name; 


int id; 

bool id_auto; 

struct device dev; // 设 备 

u32 num resources; /资源 数量 
struct resource "resource; /资源 
const struct platform device id *id entry; 


i Do UJ] 4 */ 


char *driver override; 


vc 
vtconsole 


平台 概念 的 引入 能 够 更 好 地 描述 设备 的 资源 信息 ， 例 如 总 线 地 址 、 中 断 、DMA 信息 等 。 
台 设 备 模型 是 对 device 与 driver 模型 的 扩展 ， 它 的 总 线 为 platform bus type: 


5] 


Y 
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js 


struct mfd cell *mfd cell; /*MFD cell 指针 */ 
struct pdev archdata archdata; IRRI Z 


平台 设备 的 注册 与 注销 接口 如 下 : 


int platform device register(struct platform device *); // 注 册 一 个 平台 设备 


void platform device unregister(struct platform device *); // 注 销 一 个 平台 设备 


平台 驱动 使 用 platform. driver 结构 描述 : 


struct platform driver { 
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平台 设备 


int (*probe)(struct platform device *); 
int (*remove)(struct platform device *); 


void (*shutdown)(struct platform device *); 


int (*suspend)(struct platform device *, pm message t state); 


int (*resume)(struct platform device *); 
struct device driver driver; 

const struct platform device id *id table; 
bool prevent deferred probe; 


区 动 必须 提供 probe 和 remove DYE, Jf H.YE probe 中 确保 设备 资源 的 可 用 性 。 


平台 驱动 还 支持 电源 管理 和 设备 停止 等 事件 。 平 台 驱 动 的 注册 接口 如 下 : 


Im 


int platform driver register(struct platform driver *drv); 


void platform driver unregister(struct platform driver *drv); 


platform driver register 和 platform driver unregister 本 质 上 就 是 调用 driver register 和 
driver unregister. -EIT] Linux. 内 核 需要 在 模块 入 


TE 


中 调用 这 两 个 函数 ， 新 的 Linux 内 核 中 只 


需要 用 module platform driver 即 可 实现 这 两 个 函数 的 功能 ， 有 具体 用 法 见 本 节 后 面 的 例 2.2。 
resource 结构 是 对 平台 资源 的 描述 ， 定 义 如 下 : 


struct resource { 


js 


在 platform device 结构 


resource size tstart; // 起 始 地 址 
resource size tend; /终止 地 址 
const char *name; // 名 称 

unsigned long flags; // 资 源 类 别 


struct resource *parent, *sibling, *child; 


#define IORESOURCE IO 0x00000100 
#define IORESOURCE MEM 0x00000200 
#define IORESOURCE IRQ 0x00000400 
#define IORESOURCE DMA 0x00000800 


/资源 上 下 级 关系 


可 以 设置 多 种 资源 信息 。 资 源 的 flags 标志 包括 : 


/IO 资源 

// 内 存 资 源 
/中 断 资 源 
//DMA 资源 


内 核 提供 了 一 组 函数 ， 用 来 获取 设备 的 资源 信息 : 
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// 根 据 资源 类 型 和 序号 来 获取 指定 的 资源 。 

struct resource * platform get resource(struct platform device *dev, unsigned int type, unsigned int num); 
/根据 序号 获取 资源 中 的 中 断 号 。 

struct int platform get irq(struct platform device *dev, unsigned int num); 
/根据 名 称 和 类 别 获取 指定 的 资源 。 

struct resource * platform get resource byname(struct platform device *dev, unsigned int type, char *name); 
/根据 名 称 获 取 资 源 中 的 中 断 号 。 


int platform get irq byname(struct platform device *dev, char *name); 


例 2.2 平台 设备 注册 实例 
本 例 代 码 在 \samples\2model\2-2module_ plateform。 核 心 代码 如 下 : 


struct test platform data 


1 
int idx; 
h 
static struct test platform data test info = ( 
Adx = 25, 
5 
static void plate test release(struct device * dev) 
1 
return ; 
} 
/定义 平台 设备 
static struct platform device plate test device = { 
name = "platetest", 
id =-], 
.dev ={ 


.platform data = &test info, 
release —plate test release, 


j » 
je 
static int plate test probe(struct platform device *pdev) 
{ 
printk (KERN INFO "plate test probe enter...\n"); 
return 0; 
} 
static int plate test remove(struct platform device *pdev) 
{ 
printk (KERN INFO "plate test probe remove...\n"); 
return 0; 
j 


/定义 平台 驱动 


static struct platform driver plate test driver = ( 


.probe = plate test probe, 
remove = plate test remove, 


.driver = ( 
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LM. 


.name platetest", 
.owner — THIS MODULE, 


H » 

e 

static int — init plateform test init (void) 

{ 
platform device register(&plate test device); 
platform driver register(&plate test driver); 
return 0; 

} 

static void — exit plateform test exit (void) 

1 
platform driver unregister(&plate test driver); 
platform device unregister(&plate test device); 

j 


运行 结果 如 下 : 


[root@urbetter drivers | insmod plateformtest.ko 
plate test probe enter... 

[root(Qurbetter drivers |? rmmod plateformtest 
plate test probe remove... 

[root(a)urbetter drivers | 


1512.3 DM9000 网 卡 平台 设备 资源 获取 实例 
本 例 为 DM9000 网 卡 设备 的 资源 获取 实例 。 核 心 代码 如 下 : 


#define S3C64XX PA DM9000 — (0x18000000)//DM9000 物理 地 址 
#define S3C64XX SZ DM9000 SZ 1M 
#define S3C64XX VA DM9000 S3C ADDR(0x03b00300) 


#define DM9000 ETH IRQ EINTO IRQ EINT(7) 
static struct resource dm9000 resources cs1[] = 
1 

[0] - 1 


.Start = S3C64XX PA DM9000 + 0x300, 
.end = S3C64XX PA DM9000 + 0x300 + 0x03, 
.flags - IORESOURCE MEM 


» 
[大 =; 
start = S3C64XX PA DM9000+ 0x300 + 0x4, 
end = S3C64XX PA DM9000 + 0x300 + 0x4 + 0x7f, 
flags = IORESOURCE MEM 
j> 
[一 | 


.start = DM9000 ETH IRQ EINTO, 
end | - DM9000 ETH IRQ EINTO, 
flags - IORESOURCE IRQ 
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} 
h 
static struct dm9000 plat data dm9000 setup csl = { 
.flags = DM9000 PLATF I6BITONLY 
h 


/平台 设备 结构 
struct platform device s3c device dm9000 cs1l = ( 


.name = "dm9000", 

id =0, 

.num resources — ARRAY SIZE(dm9000_resources_cs1), 
resource — dm9000 resources csl, 

.dev ={ 


.platform data = &dm9000 setup csl, 


js 
注册 MMC 平台 设备 驱动 的 代码 如 下 : 


static struct platform driver dm9000 driver= { 


.driver ={ 
.name = "dm9000", 
.pm = &dm9000 drv pm ops, 


.of match table = of match ptr(dm9000 of matches), 


j ^? 
.probe = dm9000 probe, 
remove = dm9000 drv remove, 


je 

module platform driver(dm9000 driver); 
上 面 的 代码 中 使 用 了 module platform driver. 取代 旧 的 模块 入 口 编写 方式 。 
数 dm9000 probe 展示 了 获取 平台 设备 资源 的 方法 : 


static int dm9000 probe(struct platform device *pdev) 

1 
struct dm9000 plat data *pdata = dev get platdata(&pdev-^dev); 
struct board. info *db; POSUI E 
struct net device *ndev; 


struct device *dev = &pdev-^dev; 


const unsigned char *mac src; 


/获取 地 址 资源 
db->addr res = platform get resource(pdev, IORESOURCE MEM, 0); 
db--data res = platform get resource(pdev, IORESOURCE MEM, 1); 
if (!db-^addr res || !db->data res) { 
dev err(db-^dev, "insufficient resources addr=%p data=%p\n", 
db->addr res, db-^data res); 
ret - -ENOENT; 


设备 检测 函 
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goto out; 
} 
/获取 中 断 号 
ndev->irq = platform get irq(pdev, 0); 
if (ndev->irq < 0) { 
dev_err(db->dev, "interrupt resource unavailable: %d\n", 


ndev->irq); 
ret = ndev->irq; 


goto out; 


2.5 Attributes 


-— 


属性 用 来 描述 内 核对 象 的 特性 。 属 性 定义 如 下 : 


"uni 


struct attribute { 
const char — *name; 
umode t mode; 

#ifdef CONFIG DEBUG LOCK ALLOC 
bool ignore_lockdep:1; 
struct lock class key *key; 
struct lock class key skey; 

#endif 

B 


一 组 属性 用 attribute group 表示 : 


struct attribute group { 


const char *name; 

umode t (*is visible)(struct kobject *,struct attribute *, int); 

umode t (*is bin visible)(struct kobject *,struct bin attribute *, int); 
struct attribute **attrs; 

struct bin attribute **bin attrs; 

h 


设备 、 驱 动 、 类 均 有 自己 的 属性 ， 这 些 属 | 
储 接口 。 具 体 定义 如 下 : 


/设备 属性 结构 
struct device attribute { 
struct attribute attr; 
Ssize t (*show)(struct device *dev, struct device attribute *attr,char *buf); 
ssize t (*store)(struct device *dev, struct device attribute *attr,const char *buf, size t count); 


LE 


EfE attribute 结构 的 基础 上 ， 增 加 了 显示 与 存 


DE 
/设备 属性 接口 
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int device create file(struct device *device,const struct device attribute *entry); 
void device remove file(struct device *dev,const struct device attribute *attr); 
// 驱 动 属性 结构 


struct driver attribute { 


struct attribute attr; 

ssize t (*show)(struct device driver *driver, char *buf); 

ssize t (*store)(struct device driver *driver, const char *buf;size t count); 
5 
// 驱 动 属性 接 


int driver create file(struct device driver *driver,const struct driver attribute *attr); 


Hl 
L 
Hi 


void driver remove file(struct device driver *driver,const struct driver attribute *attr); 
// 类 属性 结构 
struct class attribute { 


struct attribute attr; 

ssize t (*show)(struct class *class, struct class attribute *attr,char *buf); 

ssize t (*store)(struct class *class, struct class attribute *attr,const char *buf, size t count); 
B 
/类 属性 接口 
intclass create file(struct class *class,const struct class attribute *attr); 


void class remove file(struct class *class,const struct class attribute *attr); 
192.4 sysfs 设备 节点 属性 实例 
本 例 演示 sysfs 设备 目录 下 的 节点 属性 的 使 用 。 
本 例 代 码 在 \samples\2model\2-3module device create file。 核 心 代码 如 下 : 


static int fgj; 
/属性 操作 函数 
static ssize t fej show(struct device *dev, struct device attribute *attr,char *buf) 


1 


return sprintf(buf, "%d\n", fgj); 
} 
static ssize t fgj store(struct device *dev, struct device attribute *attr,const char *buf, size t count) 
1 

sscanf(buf, "96d", &fgj); 

return count; 


j 
/属性 定义 


static struct device attribute fgj attribute = 


1 
.attr= 
{ 
.name-"fgj", 
.mode-0644, 
j ^5 
.show-fgj show, 
.Store=fgj store, 
h 


57 


Linux 驱动 程序 开发 实例 


58 


第 2 版 


struct test platform data 


1 

int idx; 

5 

static struct test platform data test info = ( 
Adx = 25, 

5h 


static void plate test release(struct device * 


1 


dev) 


return ; 
} 
/设备 定义 
static struct platform device plate test device = { 
name = "platetest", 
id =-], 
.dev ={ 


= &test_info, 
.Telease =plate_test_release, 


.platform data 


Ph: 
ls 
/创建 设备 的 属性 文件 


m 
i 


static int 


1 


plate test probe(struct platform device *pdev) 


printk (KERN INFO "plate test probe enter..n"); 
device create file(&pdev-»dev,&fpj attribute);// 创 建设 备 属性 


return 0; 


} 
本 例 运行 结果 如 下 : 


[root@urbetter drivers]# insmod devicecreatetest.ko 


plate_test_probe enter... 
[root@urbetter drivers]? cd /sys 
[root@urbetter sys]? ls 

block 
bus 


class devices fs 


dev firmware kernel 
[root@urbetter sys]? cd devices/ 
[root@urbetter devices] ls 
dma-pl080s.0 dma-pl080s.1 
[root@urbetter devices]? cd platform/ 


[root@urbetter platform | ls 


platform 


alarmtimer s3c-sdhci.0 
dm9000.0 s3c2410-ohci 
platetest s3c2410-wdt 
power s3c2440-12c.0 
s3c-fb s3c2440-12c.1 
s3c-hsotg s3c6400-nand 


module 
power 


system 


s3c6400-uart.O 
s3c6400-uart.1 
S3c6400-uart.2 
S3c6400-uart.3 
S3c64xx-adc 

s3c64xx-pata.0 


virtual 


s3c64xx-rtc 
samsung-ac97 
samsung-1i2s.2 
samsung-keypad 
samsung-pwm 
serial8250 


smsc911x 
snd-soc-dummy 
soc-audio 
uevent 


wm29713-codec 
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[root@urbetter platform]# cd platetest/ 

[root@urbetter platetest]# ls 

driver fgj power uevent 
driver override —— modalias subsystem 

[root(Q)urbetter platetest]# cat fgj 

0 

[root(Qurbetter platetest]# echo 9 >fgj 

[root(Q)urbetter platetest]# cat fgj 

9 


(912.5 sysfs 节点 属性 组 实例 
本 例 代 码 来 自 内 核 \inux-4.5.2\samples\kobject\kobject-example.c。 核 心 代码 如 下 : 


static struct kobj attribute foo attribute = 

.. ATTR(foo, 0664, foo show, foo store); 
static struct kobj attribute baz attribute = 

. ATTR(baz, 0664, b show, b store); 
static struct kobj attribute bar attribute — 

. ATTR(bar, 0664, b show, b store); 
static struct attribute *attrs[] = 1 

&foo attribute.attr, 

&baz attribute.attr, 

&bar attribute.attr, 


NULL, 
lis 
/定义 属性 组 


static struct attribute group attr group = ( 
.attrs — attrs, 

h 

static struct kobject *example kobj; 


static int init example init(void) 


{ 
int retval; 
example kobj = kobject create and add("kobject example", kernel kobj); 
if (lexample kobj) 
return -ENOMEM; 
retval = sysfs create group(example kobj, &attr group); 
if (retval) 
kobject put(example kobj); 
return retval; 
j 
static vold — exit example exit(void) 
{ 
kobject put(example kobj); 
j 


. ATTR 宏 用 来 快速 建立 属性 。 本 例 运行 结果 如 下 : 
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[root@urbetter drivers |Z insmod sysfsdemo.ko 
[root(Qurbetter drivers |? cd /sys 


[root(a)urbetter sys]? ls 
block class 
bus dev 


[root(Q)urbetter sys]? cd kernel/ 


[root(a)urbetter kernel]? Is 


fscaps mm 


kobject example notes 


devices fs module 
firmware kernel power 
slab uevent seqnum 


uevent helper 


[root(Q)urbetter kernel]? cd kobject example/ 


[root(Qurbetter kobject example |]? Is 


bar baz foo 


[root@urbetter kobject example] cat foo 


0 


[root@urbetter kobject example] echo 1 >foo 


[root@urbetter kobject example] cat foo 


1 


[root@urbetter kobject_example]# 


2.6 设备 事件 通知 


2.6.1 kobject uevent 


Jim 


kobject uevent 是 内 核 主动 发 送 给 应 用 层 的 设备 事件 。kobject uevent 事件 包括 以 下 


enum kobject action { 
KOBJ ADD, 
KOBJ REMOVE, 
KOBJ CHANGE, 
KOBJ MOVE, 
KOBJ ONLINE, 
KOBJ OFFLINE, 
KOBJ MAX 


js 


kobject uevent 是 基于 Netlink 机 


/添加 
/删除 
// 变 更 
// 移 动 
/在 线 
/下 线 


核 初 始 化 时 会 创建 一 个 Netlink 服务 : 


Tt 


关 《〈 本 书后 面 章节 将 会 深入 分 析 ) 的 事 伯 


static int uevent net init(struct net *net) 


1 


ue sk->sk = netlink kernel create(net, NETLINK KOBJECT UEVENT, &cfg); 


if (lue sk-»sk) 1 


printk(KERN ERR 
"kobject uevent: unable to create netlink socket! n"); 


kfree(ue sk); 


return -ENODEV; 
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j 

mutex lock(&uevent sock mutex); 

list add tail(&ue sk->list, &uevent sock list); 
mutex unlock(&uevent sock mutex); 


[v 


内 核 事 件 通过 kobject uevent 函数 发 出 : 


int kobject uevent(struct kobject *kobj, enum kobject action action) 


1 


return kobject uevent env(kobj, action, NULL); 


j 


kobject uevent 调用 了 kobject uevent env FAX. kobject uevent env 函数 会 组 装 事件 信息 
包 ， 并 广播 给 Netlink 客户 端 ; 


int kobject uevent env(struct kobject *kobj, enum kobject action action,char *envp_ext[]) 
{ 

// 先 进行 事件 过 滤 ， 看 是 否 需 要 放弃 发 送 ，kset 的 uevent_ops 派 上 用 场 

kset = top kobj->kset; 


uevent ops = kset->uevent ops; 
if (uevent ops && uevent ops->filter) 
if ('uevent ops->filter(kset, kobj)) 1 
pr debug("kobject: '%s' (Top): Vos: filter function " 
"caused the event to drop'n",kobject name(kobj), kobj, func ); 
return 0; 


j 


/组 装 事 件 信息 
retval = add uevent var(env, "ACTION=%s", action string); 

if (retval)goto exit; 

retval = add uevent var(env, "DEVPATH=%s", devpath); 

if (retval)goto exit; 

retval = add uevent var(env, "SUBSYSTEM=%s", subsystem); 
if (retval)goto exit; 


list for each entry(ue sk, &uevent sock list, list) {// 遍 历 uevent sock 链表 
retval = netlink broadcast filtered(uevent sock, skb, 
0, 1, GFP KERNEL,kobj bcast filter,kobj);// 广 播 事 件 


j 
2.6.2  uevent helper 


假设 内 核 配 置 成 支持 uevent helper， 那 么 内 核 的 kobject uevent env 函数 还 会 调用 应 用 层 
的 uevent helper 程序 。 执 行 make menuconfig 后 进入 Linux 配置 菜单 的 【device drivers】--> 
[sGeneric Driver Options】， 配 置 如 图 2-1 所 示 。 
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[+] Support for uevwent helper 
(/sbin/hotplug) path to uewent helper 
[ ] Maintain a devtmpfs filesystem to mount at /dew 
[*] Select only drivers that don’t need compile-time external firmware 
[*] Prevent firmware from being built 
—*- Userspace firmware loading support 
[*] Include in-kernel firmware blobs in kernel binary 
o External firmware blobs to build into the kernel bihary 
[ ] Fallback user-helper invocation for firmware loading 
[ ] Driver Core werbose debug messages 
] Managed dewice resources verbose debug messages 


图 2-1 内 核 支持 uevent helper 


kobject uevent env KUA uevent helper 的 代码 如 下 : 


int kobject uevent env(struct kobject *kobj, enum kobject action action,char *envp ext[]) 


1 


#ifdef CONFIG UEVENT HELPER 

/*call uevent helper, usually only enabled during early boot*/ 

if (uevent helper[0] && !kobj usermode filter(kobj)) { 
struct subprocess info *info; 
retval = add uevent var(env, "HOME-/"); 
if (retval)goto exit; 
retval = add uevent var(env, PATH-/sbin:/bin:/usr/sbin:/usr/bin"); 
if (retval)goto exit; 
retval = init uevent argv(env, subsystem); 
if (retval)goto exit; 
retval = -ENOMEM; 
/进一步 建立 参数 
info = call usermodehelper setup(env->argv[0], env->argv, 

env->envp, GFP KERNEL,NULL, cleanup uevent env, env); 


if (info) { 
retval = call usermodehelper exec(info; UMH NO_WAIT;/ 启 动 应 用 程序 
env = NULL; 
} 
} 
#endif 


} 
/上 面 调用 的 init uevent argv 函数 用 来 初始 化 参数 
static int init uevent argv(struct kobj uevent env *env, const char *subsystem) 


1 
int len; 
env-»argv[0] = uevent helper; 
env-»argv[1] = &env->buf[env->buflen]; 
env->argv[2] = NULL; 
env->buflen += len + 1; 
return 0; 

} 
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可 见 call_usermodehelper exec KUAS f —® uevent helper 程序 ， 该 程序 的 路 径 保存 


在 uevent helper 数组 中 。uevent helper 程序 可 以 通过 /sys/kernel 的 uevent helper 


属性 节点 或 


/proc/sys/kernel/hotplug 节点 来 设置 。 下 面 的 例子 就 是 把 mdev 作为 uevent_helper 程序 。 


[root@urbetter kernel] echo /sbin/mdev > /proc/sys/kernel/hotplug 
[root(a)urbetter kernel] pwd 

/proc/sys/kernel 

[root(a)urbetter kernel |? cat hotplug 

/sbin/mdev 

[root(a)urbetter kernel]? cd /sys/kernel/ 

[root(a)urbetter kernel]? Is 


fscaps notes uevent helper 
mm slab uevent seqnum 
[root(Qurbetter kernel] cat uevent helper 
/sbin/mdev 


Linux 下 设备 管理 通常 使 用 udev LH. mdev 是 busybox 工具 


ACE ONG IR BUE 


成 uevent helper 程序 。 


包 中 的 设备 管理 工具 ， 用 
udev. udev 包含 一 个 一 直 运 行 的 udevd 后 台 进 程 。 与 udev 不 同 ， 
mdev 不 是 一 直 运 行 的 后 台 程序 ， 它 使 用 的 是 内 核 唤醒 方式 ， 在 系统 启动 时 必须 将 mdev 设置 


2.6.5 udev 
udev 是 一 种 应 用 层 工 具 ， 提 供 一 个 基于 用 户 空间 的 动态 设备 节点 管理 和 命名 的 解决 方案 ， 
它 能 够 根据 系统 中 的 硬件 设备 的 状态 动态 更 新 设备 文件 ， 包 括 设 备 文 件 的 创建 、 删 除 、 块 设 


备 的 加 载 等 。 
udev 的 主体 部 分 在 udevd.c 文件 中 ， 它 主要 监控 来 
hotplug 事件 、 配 置 文件 变化 的 事件 。 当 有 设备 插 


udev 客户 端的 控制 消息 、 内 核 的 
入 /拔除 Chotplug) 时 ，udev 就 会 收 到 通 
程序 ， 创 建 或 删除 /dev 


知 ， 它 会 根据 事件 中 所 带 参数 和 sysfs 中 的 信息 ， 调 用 合适 的 事件 处 理 
udev 是 通过 Netlink 机 制 获取 内 核 的 uevent 事件 的 。 注 意 在 一 些 蔡 入 式 系统 中 ，1 


A 
Tx 


源 有 限 ， 设 备 的 变动 也 不 频繁 ， 所 以 使 用 mdev 代替 udev 实现 设备 管理 功能 ， 而 mdev 是 通 


过 直接 访问 /sys/class/ 目 录 来 获取 设备 信息 的 。 
udev 按照 规则 文件 中 的 规则 处 理 uevent 事件 。udev 规则 文件 在 目 


录 /etc/udev/rules.d 下 


面 。udev 通过 文件 系统 的 inotify 功能 ， 监 控 其 规则 文件 目录 /etc/udev/rules.d， 
规则 文件 有 变化 ， 它 就 重新 加 载 规则 文件 。 


旦 该 目录 中 


udev 规则 文件 中 一 个 不 以 "##' 开 头 的 行 就 是 一 条 


常用 的 键 如 下 : 


SUBSYSTEM: 匹配 子 系统 
ACTION: 匹配 动作 
KERNEL: [匹配 内 核 名 
RUN: 执行 程序 

NAME: 设备 节点 命名 


规则 。 每 条 规则 包含 匹配 键 与 执行 键 。 匹 配 键 以 "==" 号 与 值 连接 ; 执行 键 用 "=" 与 值 连接 。 
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SYMLINK: 创建 软 链接 
下 面 截取 一 段 规 则 文件 作为 示例 : 


# Media automounting 


子 系统 为 "block"， 动 作为 "add" 或 者 "remove"， 均 执行 /etc/udev/scripts/mount.sh 
SUBSYSTEM--"block", ACTION=="add" RUN+="/etc/udev/scripts/mount.sh" 
SUBSYSTEM--"block", ACTION=="remove" RUN+="/etc/udev/scripts/mount.sh" 
# Handle network interface setup 


a 


当 子 系统 为 "net"， 动 作为 "add" 或 者 "remove"， 均 执行 /etc/udev/scripts/network.sh 
SUBSYSTEM--"net", ACTION=="add" RUN+="/etc/udev/scripts/network. sh" 
SUBSYSTEM--"net", ACTION=="remove" RUN+="/etc/udev/scripts/network.sh" 
# SCSI devices 


a 


当 子 系统 为 " scsi "， 内 核 名 为 sr[0-9]*， 均 创建 scd 节点 与 sr 软 链接 


IS 


SUBSYSTEMS--'scsi", KERNEL--"sr[0-9]*", NAME="scd%n", SYMLINK--"sr?on" 


2. 设备 树 


设备 树 (Device Tree) 用 来 描述 板 卡 的 板 级 硬件 信息 。Linux 源码 的 arch 目录 下 有 大 量 的 
设备 板 级 信息 描述 文件 ， 采 用 设备 树 后 ， 内 核 不 用 再 包含 大 量 的 硬件 描述 文件 ， 当 板 卡 的 硬件 
接口 信息 变动 而 驱动 逻辑 没有 变化 时 ， 只 需要 修改 设备 树 ， 而 不 需要 修改 内 核 代码 。 设 备 树 文 
件 位 于 Linux 内 核 源 代码 arch/arm/boot/dts 目录 下 面 ， 其 中 dts 文件 为 板 级 定义 ，dtsi 文件 为 


T 


Soc 级 定义 。 编 译 Linux 设备 树 的 命令 为 make dtbs， 生 成 *.dtb 文件 (Device Tree Blob). ix 
备 树 文件 编译 之 后 会 被 放 到 一 个 独立 的 存储 区 ，bootloader 启动 时 会 将 设备 树 信 息 读 入 内 存 ， 


并 将 该 内 存 地 址 传递 给 Linux 内 核 。 内 核 在 启动 时 会 建立 设备 树 节 点 : 


void  initsetup arch(char **cmdline p) 
1 


mdesc = setup machine fdt( atags pointer); /建立 设备 树 


unflatten device tree0; /扫描 设备 树 ， 将 设备 树 组 织 成 device node 结构 用 于 后 面 解析 信息 


SN 


arm dt init cpu maps(); 
psci dt init(); 


j 


代码 中 的 fdt 即 遍 平 设备 树 (Flat Device Tree)， 在 内 存 中 连续 存储 。 上 面 的 _atags 


pointer 参数 就 是 bootloader 传递 给 内 核 的 设备 树 地 址 ， 放 在 处 理 器 的 R2 寄存 器 中 ， 


源码 的 arch/arm/kernel/head-common.S 文件 中 的 _mmap switched H 
设备 树 的 基本 框架 如 下 : 


// 引 自 http://elinux.org/Device Tree Usage#PCI Address Translation 


{ 
nodel {// 节 点 名 
a-string-property = "A string"; // 字 符 串 属性 
a-string-list-property = "first string", "second string"; /字符 串 表 属性 
a-byte-data-property = [01 23 34 56]; IRSE, 163b 
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child-nodel {/ 子 节点 
first-child-property; 
second-child-property = «17; 
a-string-property — "Hello, world"; 
h 
child-node2 {// 子 节点 2 
h 


label: node2 { 


js 


an-empty-property ; 

a-cell-property = «1 2 3 4»; /* 每 个 数字 为 无 符号 整 型 */ 
child-nodel { 

h 
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节点 名 格式 为 <name>[@<unit-address>]。 每 个 节点 必须 有 一 个 compatible 属性 ， 描 述 制 
造 商 与 模块 信息 。compatible 属性 是 设备 标识 ， 它 决定 了 设备 将 与 哪个 驱动 绑 定 。 公 共 的 节 
点 属性 包括 寄存 器 (reg)、 中 断 (interrupts )、 管 脚 控制 (pinctrl-names、pinctrl-0)、 时 钟 


=j 


(clocks). 等 ， 此 外 还 有 一 些 设备 特定 的 属性 。 下 面 是 内 核 at91sam9g45.dtsi 文件 中 的 PC 控 


DUE MESE 


12c0: i2c(a)fff84000 1 
compatible = "atmel,at91sam9g10-i2c"; /设备 标识 
reg = «OxfIf84000 0x100>;// 内 存 映 射 型 设备 ， 寄 存 器 ， 起 始 地 址 为 0xfff84000， 长 度 为 0x100 
interrupts --12IRQ TYPE LEVEL HIGH 6»; /中断 号 与 类 型 


pinctrl-names = "default"; 


pinctrl-0 = «&pinctrl i2c0>; // 管 脚 控制 采用 pinctrl i2c0 节点 
#address-cells = «17; /设置 子 节点 reg 属性 的 地 址 个 数 
#size-cells = <0>; 1/ 设置 子 


clocks = <&twi0_clk>; 时 钟 采用 twi0_clk 节点 


节点 reg 属性 的 长 度 信息 ，0 表示 无 长 度 信 息 


status = "disabled"; // 状 态 
5 
内 核 源码 中 的 at91sam9m10g45ek.dts 文件 包含 了 at91sam9g45.dtsi 文件 ， 下 面 是 其 中 的 


DC 设备 节点 的 


述 : 


#include "at91sam9g45.dtsi" 
i2c0: i2c@fff84000 { 


status = "okay"; /状态 
0v2640: camera@30 ( // 地 址 为 0x30 的 摄像 头 
compatible = "ovti,ov2640"; /标识 


reg=<0x30>; ”// 非 内 存 映 射 型 设备 ，I2C 设备 地 址 为 0x30 


pinctrl-names = "default"; 


pinctrl-0 = «&pinctrl pckl as isi mck &pinctrl sensor power &pinctrl sensor reset»; 


resetb-gpios = «&pioD 12 GPIO ACTIVE LOW»; URNE W 
pwdn-gpios = «&pioD 13 GPIO ACTIVE HIGH»; /电源 管理 管 脚 
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clocks = <&pck1>; /时 钟 采 用 pckl 节点 


h 
B 
ov2640 摄像 头 设备 节点 为 DC 控制 器 节点 的 子 节点 ， 它 的 reg 属性 受到 父 节点 的 
Zaddress-cells 与 #size-cells 约束 。 
device 结构 的 of node 成 员 指 向 设备 关联 的 设备 树 。device 结构 包含 在 其 他 设备 结构 
中 ， 如 platform device 结构 。 假 如 已 知 平台 设备 platform device *op 结构 ， 则 可 通过 op-> 
dev. of node 访问 设备 树 。 反 之 ， 通 过 设备 树 查 找平 台 设 备 的 函数 如 下 : 


struct platform device *of find device by node(struct device node *np); 


内 核 中 定义 了 一 系列 设备 树 API， 具 体 代码 在 /drivers/of 目录 下 。 主 要 的 设备 树 函 数 如 下 : 


/判断 节点 的 compatible 属性 是 否 包 含 name 

int of device is compatible(const struct device node *device,const char *name); 

/根据 设备 节点 的 compatible 属性 寻找 节点 

struct device node *of find compatible node(struct device node *from,const char *type,const char *compat); 
/获取 属性 
void *of get property(const struct device node *node,const char *name,int *lenp); 
/获取 字 节 型 属性 的 值 

int of property read u8(const struct device node *np,const char *propname,u8 *out value); 
// 读 字 节 数组 型 的 属性 
int of property read u8 array(const struct device node *np,const char *propname, u8 *out values, size t sz); 
/ 读 字符 串 型 的 属性 
int of property read string(struct device node *np,const char *propname,const char **out string); 
/获取 中 断 


unsigned int irq of parse and map(struct device node *dev,int index); 


— 
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务 。Linux 操作 系统 中 包含 众多 的 同步 机 


并 行 运算 ， 因 
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众所周知 ，Linux 是 一 个 多 用 户 多 外 
为 线程 是 同时 执行 的 。T 
占 实现 的 ， 即 
时 ， 必 须 使 用 有 效 的 机 


'a 


mu 


Hi 


通过 临时 中 断 一 个 
Jp qan 
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E 务 操作 系统 。 在 多 处 型 


在 单 处 


里 器 Cuniprocessor, UP) 情形 ， 
线程 以 执行 另 一 个 线程 的 方式 来 实现 。 当 存在 并 发 访 
同步 和 保护 资源 。 另 儿 


器 (SMP) 情况 下 存在 真正 的 


uy 


对 中 断 的 处 理 也 会 打 断 正在 运行 
Bj, Gia gE (semaphore), HIED (spinlock)、 


, 并 行 是 i 


通过 
的 可 
的 任 


I] 


原子 操作 Catomic operation )、 读 写 锁 (rwlock). RCU 和 seqlock， 每 种 机 制 应 
随 着 Linux 从 单 处 理 器 内 核发 展 到 对 称 多 处 理 器 内 核 、 


Z^ 
FT o 


3.1 


原子 操作 


原子 操作 是 一 系列 不 可 中 断 的 操作 的 


处 理 器 系统 中 ， 能 够 在 单条 指令 ， 
中 ， 即 使 能 在 单条 指令 中 完成 的 操作 也 有 可 
有 硬件 的 支持 ， 因 此 是 和 平台 相关 的 ， 而 


ERNA 


些 机 制 越 来 越 高 效 ， 也 越 来 越 复 杂 。 本 章 3 


f^. 


它 的 执行 


SE 


从 非 抢占 内 核发 展 到 抢 


1 Linux 内 核 的 各 种 同步 机 制 。 


Ak 
He 


通常 使 用 汇编 


常 被 定义 成 原子 型 整数 (atomic tf) 类 型 : 


typedef struct ( volatile int counter; ) atomic t; 


volatile 修饰 符 告 诉 编译 器 不 要 对 该 类 型 的 数据 做 优化 处 理 


原子 操作 包含 整数 型 和 比特 型 ， 见 表 3-1。 


o 


j 在 不 同 场 


占 内 核 ， 这 


软件 单独 保证 ， 必 须 
语言 实现 。 原 子 操作 保护 的 资源 通 


过 程 是 封闭 的 ， 不 可 打 断 的 。 在 单 
完成 的 操作 都 可 以 认为 是 原子 操作 。 在 对 称 多 处 理 器 结构 
可 能 被 打 断 。 原 子 性 不 可 


表 3-1 原子 操作 函数 
类 型 函数 原型 说 明 
atomic read(atomic t * v); 原子 读 操作 
— atomic set(atomic t * v, int i); 设置 原子 类 型 的 变量 v 的 值 为 i 
void atomic add(int i, atomic t *v); 给 原子 类 型 的 变量 v 增加 值 i 
void atomic sub(int i, atomic t *v); 从 原子 类 型 的 变量 v PIRA i 
int set_bit(int nr, void *addr) ; 对 给 定 地 址 addr 的 第 nr bit 进行 置 位 
m int clear bit(int nr, void *addr); 对 给 定 地 址 addr 的 第 nr bit 进行 清 位 
int test_bit(int nr, void *add) ; 检测 给 定 地 址 addr 的 第 nr bit 的 值 
int change bit(int nr, void *addr) ; 使 地 址 addr 的 第 nr bit 发 生 跳 转 (0 279 1, 1 变 为 0) 
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3.2. SHELE 


32.4 jemi 


自 旋 的 意思 就 是 一 直 循环 直到 条 件 满足 。 自 旋 锁 不 会 
被 别 的 执行 单元 占有 ， 调 用 者 就 一 直 循环 查看 是 否 该 自 旋 锁 的 保持 者 已 经 释放 了 锁 。 如 果 不 


2u 
BeA 


要 用 于 


E 很 短 的 时 间 内 获得 锁 ， 这 无 疑 会 导致 CPU 效率 降低 。 


ARM 体系 下 的 自 旋 锁 相 关 的 结构 如 下 : 


让 
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typedef struct { 
volatile unsigned int lock; 
} arch. spinlock t; 
typedef struct raw spinlock { 
arch spinlock t raw_ lock; 


} raw spinlock t; 
typedef struct { 


raw spinlock t raw lock; 


} spinlock t; 


与 自 旋 锁 相 关 的 函数 主要 包括 以 下 几 个 : 


spin lock init(lock); // 初 始 化 自 旋 锁 
spin lock(lock); /获得 自 旋 锁 

spin trylock(lock); /尝试 获得 自 旋 锁 
spin unlock(lock); /释放 自 旋 锁 


| 起 调用 者 睡眠 ， 如 果 自 旋 锁 已 经 


spin lock 函数 在 获得 锁 后 将 立即 返回 ， 和 否则 在 原 地 等 待 ， 直 到 获得 锁 。spin_trylock K 
数 尝试 获得 自 旋 锁 lock， 如 果 能 立即 获得 锁 ， 则 返回 真 ， 和 否则 立即 返回 假 。 


中 断 安全 的 自 旋 锁 函 数 如 下 : 


/硬件 中 断 安全 
spin lock irq(lock); spin unlock irq(lock); 


spin lock irgsave (lock,flag); spin unlock irqrestore (lock.flag); 


/软件 中 断 安全 的 自 旋 锁 
spin lock bh(lock); spin unlock bh(lock); 


spin lock irq 函数 获得 自 旋 锁 的 同时 会 禁止 本 地 CPU | 
PE PET, MEH spin lock irq 函数 。spin lock irq 5 spin unlock irq 成 对 使 


断 的 状态 ， 在 解锁 时 需 用 spin unlock irqrestore 函数 恢复 ， 
例 3.1 自 旋 锁 实例 
假设 simple count 变量 初始 值 为 0， 坟 


]. spin lock irqsave 与 spin unlock irqsave 成 对 使 用 。spin lock irqsave 函数 会 保存 本 地 


上 的 


断 与 内 核 抢占 。 当 自 旋 锁 需 


O 


断 的 状态 。 


期 望 该 变量 的 值 不 大 于 1。 在 多 CPU 的 情况 和 可 
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抢占 内 核 中 ， 如 下 代码 并 不 能 保障 simple count 不 出 现 大 于 1 的 值 : 


int simple count-0; 
if (simple count) 
1 
return - EBUSY; 


j 
simple count; 
下 面 这 个 例子 演示 使 用 自 旋 锁 保 护 simple count FÆDRE, 8 
户 同时 打开 。 代 码 见 \samples\3synchronous\3-1spinlock。 
设备 打开 与 关闭 函数 代码 如 下 : 


static int simplespin count= 0; 
static spinlock t spin = SPIN LOCK UNLOCKED; 
static int simplespin open(struct inode *inode, struct file *filp) 
1 
PESCE EL EB 
spin lock(&spin); 
RIVA HIT 
if (simplespin count) 


1 


spin unlock(&spin); 
return - EBUSY; 
j 
simplespin count; 
PORE ELE Cn 
spin unlock(&spin); 
return 0; 


j 


static int simplespin release(struct inode *inode, struct file *filp) 


1 
simplespin count--; 
return 0; 


j 
应 用 层 参考 代码 如 下 : 


void main() 


1 
int fd; 
fd—open("/dev/fgj",|O. RDWR); 
if(fd==-1) 
1 


perror("error open"); 
exit(- 1); 
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保 该 设备 不 被 多 个 用 
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printf("open /dev/fgj successfully Wn"); 


while(1); 
close(fd); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter drivers]# insmod spinlock.ko 
chardev register success 

[root(a)urbetter drivers]# mknod /dev/fgj c 224 0 
[root(Qurbetter drivers]? ./test& 

[root(g)urbetter drivers]? open /dev/fgj successfully 
次 打开 会 失败 

[root@urbetter drivers]? ./test 


error open 


: Device or resource busy 
[root@urbetter drivers | 


3.2.2” 读 写 锁 


读 写 锁 (rwlock) 实际 是 一 种 特殊 的 自 旋 锁 。 在 实际 应 用 中 如 果 需 要 对 某 个 数据 的 读 操 
作 和 写 操作 进行 有 区 别 的 加 锁 时 ， 可 以 使 用 读 写 锁 。 读 写 锁 把 对 共享 资源 的 访问 者 划分 成 读 
者 和 写 者 ， 读 者 只 对 共享 资源 进行 读 访问 ， 写 者 则 需要 对 共享 资源 进行 写 操作 。 

读 写 锁 相对 于 普通 自 旋 锁 而 言 ， 能 提高 并 发 性 ， 因 为 在 多 处 理 器 系统 中 ， 它 允许 同时 有 
多 个 读者 来 访问 共享 资源 。 写 者 是 排他 性 的 ， 一 个 读 写 锁 同时 只 能 有 一 个 写 者 或 多 个 读者 ， 
但 不 能 同时 既 有 读者 又 有 写 者 。 在 读 写 锁 保 持 期 间 也 是 抢占 失效 的 。 如 果 读 写 锁 当 前 没有 读 
者 也 没有 写 者 ， 那 么 写 者 可 以 立刻 获得 读 写 锁 ， 和 否则 它 必 须 自 旋 ， 直 到 没有 任何 写 者 或 读 
者 。 如 果 读 写 锁 没有 写 者 ， 那 么 读者 可 以 立即 获得 该 读 写 锁 ， 否 则 读者 必须 自 旋 ， 直 到 写 者 
释放 该 读 写 锁 。 在 ARM 平台 上 ， 内 核 用 32bit 的 数据 来 记录 读 写 锁 中 读 写 线程 的 数量 ， 最 
高 位 为 写 者 的 数量 ， 上 只 允许 一 个 ;0 一 30bit 记录 读者 的 数量 (具体 见 内 核 arch. read lock. 与 
arch write lock 代码 )。 

读 写 锁 的 类 型 是 rwlock t。 初 始 化 读 写 锁 的 方法 有 两 种 ， 一 利 


pag 


是 动态 初始 化 ， 一 种 是 静 


态 初 始 化 。 
rwlock t x; 
rwlock init(x) ; /动态 初始 化 读 写 锁 x 


rwlock t x=RW LOCK UNLOCKED /静态 初始 化 
读 锁 最 基本 的 函数 组 合 如 下 : 
/获得 读 锁 。 如 果 不 能 获得 锁 ， 它 将 自 旋 ， 直 至 
read lock(lock); 
/释放 读 锁 
read unlock(lock); 
写 锁 最 基本 的 函数 组 合 如 下 : 
70 
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使 月 


read trylock(lock) ; 
write trylock(lock); 


日 读 写 锁 的 示例 代码 如 下 : 


rwlock t lock; 


static ssize t simple read(struct file *filp, char *buf, size t len, loff t*off) 
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/获得 写 锁 ， 如 果 不 能 获得 锁 ， 它 将 自 旋 ， 直 到 获得 该 写 锁 
write lock(lock); 
/释放 读 写 锁 
write unlock(lock); 
ig EE BEC FE, x BU) IDA CE e Dt T ZRVAAIBUMG XP^ RRO, IIR 
得 锁 返 回 真 ， 否 则 返回 假 : 


种 高 性 能 的 锁 机 制 ， 具 有 很 


用 于 读 多 写 少 的 情况 。RCU 的 原理 


以 访问 它 ， 但 写 者 在 访问 


1 
int count-len; 
read lock(&lock); /加 读 锁 
if (copy to user(buf,demoBuffer,count)) 
1 
count--EFAULT; 
} 
read unlock(&lock); /释放 读 锁 
return count; 
} 
static ssize t simple write(struct file *filp, const char *buf, size t len,loff t *off) 
1 
int count-len; 
write lock(&lock); /加 写 锁 
if (copy from user(demoBuffer, buf, count)) 
1 
count — -EFAULT; 
} 
write unlock(&lock); /释放 写 锁 
return count; 
} 
static int — init simplerwlock init(void) 
1 
rwlock init(&lock); 
} 
3.2.3 RCU 
RCU 就 是 读 -复制 -修改 (Read-Copy-Update) 的 意思 ， 它 是 一 
好 的 扩展 性 。 但 是 这 种 锁 机 制 的 使 用 范围 比较 罕 ， 具 适 
是 对 于 被 RCU 保护 的 共享 数据 结构 ， 读 者 不 需要 获得 任何 锁 就 可 
它 时 需要 先 复制 一 个 副本 ， 然 后 对 副本 进行 修改 ， 最 后 调 


用 一 个 回调 〈callback) 函数 在 适 
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当 的 时 机 把 指向 原来 数据 的 指针 指向 新 的 被 修改 的 数据 。 这 个 时 机 就 是 所 有 引 
务 都 退出 对 共享 数据 的 操作 。 
RCU 读者 最 基本 的 函数 组 合 如 下 : 


用 该 数据 的 任 


#define rcu read lock() preempt disable() // 进 入 读 操作 临界 区 标记 

#define rcu read unlock() preempt enable() // 退 出 读 操作 临界 区 

RCU 写 者 一 般 先 对 副本 进行 操作 ， 然 后 将 副本 设 定 为 新 正本 ， 最 后 同步 或 者 异步 地 释 
放 旧 的 正本 。call_ rcu 函数 为 异步 机 制 ，synchronize reu 函数 为 同步 机 制 。 函 数 原 型 如 下 : 


struct rcu head { 
struct rcu head *next; /下 一 个 rcu_ head 
void (*func)(struct rcu head *head); /获得 竞争 条 件 后 的 处 理 函 数 


5n 

/添加 回调 函数 ， 保 护 期 结束 后 会 调用 该 回调 函数 
void call rcu(struct rcu head *head, rcu. callback t func) ; 
/同步 rcu， 等 待 直到 保护 期 结束 


void synchronize rcu(void); 


call rcu. 函数 调用 后 ， 直 接 返 回 ，RCU 软 中 断 会 调用 回调 函数 释放 旧 数 据 指 针 。 
synchronize rcu 函数 则 会 原 地 等 待 ， 它 被 唤醒 时 ， 即 可 释放 旧 数 据 指 针 。 

例 3.2 RCU 实例 

代码 见 \samples\3synchronous\3-2rcu。 核 心 代码 如 下 : 


// 保 护 的 数据 
#define DATA SIZE 16 
struct protectRcu 


1 
char protect|[DATA SIZE]; 
struct rcu head rcu; 
h 
struct protectRcu*global pr-NULL; 
/回调 函数 ， 一 般 用 来 释放 旧 数 据 


void callback function(struct rcu head *r) 


1 
struct protectRcu *t; 
t= container of (r, struct protectRcu, rcu ); 
kfree (t); 
printk("callback function kfree Wn"); 
j 


struct DEMO dev *DEMO devices; 
static unsigned char demo inc-0; 
static u8 writeBuffer[DATA SIZE]; 
static spinlock t rcu spinlock; 
int DEMO open(struct inode *inode, struct file *filp) 
1 
struct DEMO dev *dev; 
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demo inct-; 

dev = container of(inode-^i cdev, struct DEMO dev, cdev); 
filp-^private data = dev; 

return 0; 


int DEMO release(struct inode *inode, struct file *filp) 


1 


j 


demo inc--; 
return 0; 


ssize t DEMO read(struct file *filp, char — user *buf, size t countloff t *f pos) 


1 


j 


int readsize-count; 

if(global pr--NULL)return 0; 

if(readsize>DATA SIZE)readsize-DATA SIZE; 

rcu read lock (); 

if(copy to user(buf;global pr-»protect,count)) 

{ 
readsize--EFAULT; dps 65 380 V FRE FP A TRI / 
goto out; 


rcu read unlock (); 


return readsize; 


ssize t DEMO wrrite(struct file *filp, const char — user *buf, size t countloff t *f pos) 


1 


j 


struct protectRcu *t,*old; 

int witesize-count; 

if(witesize>DATA SIZE)witesize-DATA SIZE; 
if(copy from user(writeBuffer, buf;witesize))return -EFAULT; 

t= kmalloc (sizeof (*t), GFP KERNEL ); /副本 

spin lock (&rcu spinlock); 


memcpy(t-- protect, writeBuffer,witesize); /操作 副本 
old- global pr; 
global pr-t; /更 新 正本 
spin unlock (&rcu spinlock); 
if(old!-NULL) 

call rcu (&old-»rcu , callback function); /异步 回调 设置 


else 
printk("old pr is NULLAn"); 


return witesize; 


struct file operations DEMO fops = 1 


.owner = THIS MODULE, 
read = DEMO read, 
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.write = DEMO write, 
open = DEMO open, 
release - DEMO release, 


js 


应 用 层 核心 代码 如 下 : 


74 


void main() 


一 一 


int fd; 
char data[256]; 
int retval; 

/打开 设备 
fd=open("/dev/fej",O_RDWR); 
if(fd==-1) 

{ 
perror("error open"); 
exit(-1); 
j 
printf("open /dev/fgj successfully n"); 
// 写 操作 
retval-write(fd,"fgj",3); 
if(retval==-1) 
{ 
perror("write error"); 
exit(-1); 
j 
// 读 操作 
retval=read(fd,data,3); 
if(retval==-1) 
{ 
perror("read error\n"); 
exit(-1); 
} 
data[retval]-0; 
printf("read successfully:?osWn",data); 
close(fd); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter drivers |? insmod rcu.ko 
[root@urbetter drivers] mknod /dev/fgj c 224 0 
[root(a)urbetter drivers]? ./test 

open /dev/fgj successfullyold pr is NULL 

read successfully:fgj 

[root(a)urbetter drivers |? ./test 

open /dev/fgj successfullycallback function kfree 
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read Successfully:fgj 
324 信号 量 
信和 号 量 是 一 种 睡眠 锁 。 假 如 有 一 个 任务 想 要 获得 已 被 占用 的 信号 量 ， 信 和 号 量 就 会 将 其 放 
入 一 个 等 待 队 列 然后 让 其 睡眠 ， 这 样 CPU 可 以 去 处 理 其 他 事情 。 持 有 信和 号 量 的 进程 将 信和 号 
释放 后 ， 处 于 等 待 队列 中 的 一 个 任务 将 被 唤醒 并 获得 信号 量 。 自 旋 锁 与 信号 量 的 第 一 个 区 别 
是 前 者 不 会 引起 调用 者 睡眠 。 自 旋 锁 与 信号 量 的 选用 应 该 取决 于 锁 被 持 有 的 时 间 长 短 。 如 果 
锁 的 持 有 时 间 较 短 ， 使 用 自 旋 锁 是 更 好 的 选择 。 自 旋 锁 与 信号 量 的 第 二 个 区 别 是 信号 量 允 许 
有 多 个 持 有 者 ， 而 自 旋 锁 只 能 有 一 个 持 有 者 。 
信号 量 〈semaphore) 的 实现 也 是 和 平台 相关 的 。 信 和 号 量 使 用 semaphore 结构 描述 ， 它 的 
结构 成 员 count 会 被 初始 化 为 最 多 的 信号 量 持 有 者 数量 。 


y 


lm 
"| 


iul 


struct semaphore 1 
raw spinlock t lock; 
unsigned int count; 
structlist head wait list;// 等 待 列表 


h 
注意 不 要 直接 访问 该 结构 的 成 员 。 信 号 量 所 允许 的 并 行 访问 的 数目 是 在 信号 量 创建 时 定 
义 的 ， 即 sema init 函数 中 的 参数 valo 


void sema init (struct semaphore *sem, int val); /初始 化 信和 号 引 


信号 量 最 基本 的 函数 组 合 如 下 : 


jus 


atu 
limi 
p 


void down(struct semaphore * sem); /获得 信 
void up(struct semaphore * sem);/ 释 放 信和 号 量 ， 唤 醒 等 待 者 


获取 信和 号 量 的 函数 包括 down. down trylock、down interruptible. down 函数 会 一 直 等 待 
号 量 。down trylock 函数 会 尝试 获取 信和 号 量 ， 假 如 信和 号 量 被 占有 则 立即 返回 。down 函数 
导致 睡眠 ， 因 此 不 能 在 中 断 上 下 文中 使 用 。 在 中 断 上 下 文中 应 该 选用 down_trylock 函数 ; 


int down trylock(struct semaphore * sem); 


down interruptible 函数 能 被 信号 打 断 ， 它 的 返回 值 如 果 是 0， 表 示 获 得 信号 量 正常 返 
; 如 果 是 -EINTR， 表 示 被 信号 打 断 。 函 数 原型 如 下 : 


加 


int down interruptible(struct semaphore * sem); 
例 3.3 信号 量 实例 
本 例 使 用 信号 量 实现 读 写 互 斥 ， 在 写 过 程 中 特意 增加 了 写 延 迟 ， 以 方便 观察 代码 运行 结 
果 。 代 人 码 风 \samples\3synchronous\3-3sem。 核 心 代码 如 下 : 


/设备 结构 
struct DEMO dev 
1 


struct semaphore sem; 
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struct cdev cdev; 


h 
ssize t DEMO read(struct file *filp, char — user *buf, size t countloff t *f pos) 
1 
struct DEMO dev *dev = filp-^private data; 
if (down interruptible(&dev-^sem)) 
return -ERESTARTSYS; 
AEA 1 9 UNE FERE t RI 
if(copy to user(buf,demoBuffer,count)) 
1 
count--EFAULT; 
} 
up(&dev->sem); 
return count; 
} 
ssize t DEMO write(struct file *filp, const char _ user *buf, size t count,loff t *f pos) 
1 
struct DEMO dev *dev = filp-^private data; 
ssize t retval = -ENOMEM; /*value used in "goto out" statements*/ 
if (down interruptible(&dev-^sem)) 
1 
return -ERESTARTSYS; 
} 
人 # 把 数据 复制 到 内 核 空间 六 
if (copy from user(demoBuffer--*f pos, buf, count)) 
1 
count = -EFAULT; 
} 
printk("write delay"); 
msleep(1000#*10);/ 模 拟 比较 耗 时 的 写 动作 
printk("write delay ok Wn"); 
up(&dev-»sem); 
return count; 
} 
int DEMO init module(void) 
{ 
sema init(&DEMO devices->sem,1);// 初 始 化 信号 量 
} 


本 例 运行 结果 如 下 : 


[root@urbetter drivers | insmod demo.ko 
[root@urbetter drivers]? mknod /dev/fgj c 224 0 
[root@urbetter drivers] write & 

open /dev/fgj successfully 

write delay 

[P8 SESERETPSEBIUR SES 

[root(Q)urbetter drivers | ./read 
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B 
[m 
B 


open /dev/fgj successfully 

I CREAR SERE Tet 

write delay ok 

read successfully:fgj 

[1]- Done / write 


32.5 ” 读 写 信号 量 


信和 号 量 也 衍生 出 了 一 种 区 分 读 写 操作 的 同步 机 制 ， 即 读 写 信号 量 (rw_semaphore)。 它 的 
原理 与 读 写 锁 差 不 多 ， 读 写 信和 号 量 相关 的 函数 如 下 ， 相 信 读 者 不 难看 出 它们 的 用 法 。 


void init rwsem(struct rw semaphore *sem); 

void down read(struct rw semaphore *sem); 

int down read trylock(struct rw semaphore *sem); 
void up read(struct rw semaphore *sem); 

void down write(struct rw semaphore *sem); 

int down write trylock(struct rw semaphore *sem); 
void up write(struct rw semaphore *sem); 


读 写 信号 量 允 许 将 写 者 降级 为 读者 ， 这 样 能 增强 并 发 性 ， 提 高 效率 。 


void downgrade write(struct rw semaphore *sem); 


downgrade write 使 用 的 伪 代 码 如 下 : 


struct rw_semaphore rw sp; 
down write(&rw sp); 


downgrade write(&rw_sp);// 降 级 写 为 读 


up read(&rw sp); 


32.6 Hy 
互 斥 量 用 mutex 结构 描述 ， 同 一 时 间 只 允许 一 个 访问 者 。 互 斥 量 加 锁 失 败 会 进入 睡眠 等 
竺 唤醒， 不 能 用 于 中 断 上 下 文 。 


struct mutex { 


atomic t count;//1= 未 加 锁 ; 0= 已 加 锁 ， 负 数 = 已 加 锁 ， 表 示 可 能 的 等 待 者 数 
spinlock t wait lock; 
struct list head wait list; 


h 
互 斥 量 相 关 的 函数 如 下 : 
void mutex init(mutex); 
void mutex lock(struct mutex *lock); 


int mutex trylock(struct mutex *lock); 
void mutex unlock(struct mutex *lock); 
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其 用 法 与 上 面 几 个 锁 非 常 相 似 ， 从 略 。 


3.3 等待 队列 


3.3.1 ”等 得 队列 原理 

等 待 队列 常用 于 异步 通知 和 阻塞 式 访 问 。 如 果 进 程 需要 等 待 某 些 条 件 发 生 才能 继续 ， 则 
可 以 使 用 等 待 队 列 机 制 。 在 Linux 内 核 中 通常 使 用 等 待 队列 来 实现 阻塞 式 访 问 。 

@ 初始 化 一 个 等 待 队 列 头 


void init waitqueue head(wait queue head t *q); 
e 等 待 事件 发 生 的 函数 
wait event(wq, condition)/ 不 可 中 断 的 等 待 
wait event interruptible(wq, condition)/ 可 中 断 的 等 待 


wait event timeout(wq, condition, timeout)// 带 超时 返回 的 等 待 
wait_event_interruptible_timeout(wq, condition, timeoubV/ 可 中 断 并 超时 返回 的 等 待 


e 唤醒 等 待 队 列 


wake up(wait queue head t *q) ;/ 唤 醒 所 有 等 待 q 的 进程 
wake up interruptible(wait queue head t*q);/ 只 唤醒 执行 可 中 断 休眠 的 进程 


e 加 入 或 退出 等 待 队 列 


void add wait queue(wait queue head t*q, wait queue t *wait) 


void add wait queue exclusive(wait queue head t *q, wait queue t *wait) 


void remove wait queue(wait queue head t *q, wait queue t *wait) 


加 入 等 待 队 列 的 线程 将 等 待 唤 醒 〈wake_up )。 阻 塞 式 字符 驱动 程序 一 般 在 读 函 数 中 等 
待 ， 并 在 中 断 或 内 核 线程 中 使 用 wake_up 函数 唤醒 等 待 队列 。 


3.3.2 ”阻塞 模式 读 实例 

非 阻 塞 模式 下 ， 如 果 没 有 数据 可 读 或 者 设备 不 可 写 ， 读 写 函 数 会 立即 返回 。 阻 塞 模 
式 下 ， 如 果 没 有 数据 可 读 或 者 设备 不 可 写 ， 读 写 函 数 会 等 待 ， 直 到 有 数据 可 读 或 者 设备 
可 与 。 

例 3.4 阻塞 式 读 驱 动 程序 实例 

代码 见 \samples\3synchronous\3-4block。 核 心 代码 如 下 : 


/设备 结构 
struct simple dev 


1 
struct semaphore sem; 
wait queue head t wq; 
struct cdev cdev; 
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h 
int simple init module(void) 
1 
init MUTEX(&simple devices-^sem); 
init waitqueue head(&simple devices-wq); 
j 
/阻塞 式 读 
ssize tsimple read(struct file *filp, char — user *buf, size_t count,loff t *f pos) 
1 
struct simple dev *dev = filp-^private data; 
/等 待 数据 到 达 
if(wait event interruptible(dev-—wq, flag != 0)) 


1 


return - ERESTARTSYS; 
j 
flag = 0; 
/获取 信号 量 
if (down interruptible(&dev-^sem)) 
return -ERESTARTSYS; 
PHE2SGIRETES SUN A REN 
if (copy to user(buf,demoBuffer,count)) 
i 
count--EFAULT; 
goto out; 


j 


out: 


uil 


up(&dev-»sem); 
return count; 
j 
/ 写 函 数 中 唤醒 
ssize tsimple write(struct file *filp, const char — user *buf, size t count,loff t *f pos) 
1 
struct simple dev *dev = filp-^private data; 
ssize t retval = -ENOMEM; /*value used in "goto out" statements*/ 
if (down interruptible(&dev-^sem)) 
1 
return -ERESTARTSYS; 
j 
if (copy from user(demoBuffer, buf, count)) { 
retval = -EFAULT; 
goto out; 
} 
up(&dev-»sem); 
flag= 1; 
/唤醒 等 竺 队列 ， 通 知 数据 可 获得 
wake up _ interruptible(&dev->wq); 
return count; 
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out: 
up(&dev-»sem); 
return retval; 


j 
本 例 运 行 结果 如 下 : 


[root(2/home]$insmod demo.ko 
Using demo.ko 

[root(2/home]$mknod /dev/fgj c 224 0 
[root(a/home]$./read & 

[1] 335 

[root@/home]$./write 

The data is FG 


下 面 介 绍 采 用 add wait queue 与 remove wait queue 函数 实现 阻塞 读 的 版 本 。 代 码 见 
\samples\3synchronous\3-5block2。 核 心 代码 如 下 : 


static atomic t flag; 
ssize t simple read(struct file *filp, char — user *buf, size t count,loff t *f pos) 
1 
int ret=0; 
struct simple dev *dev = filp-^private data; 
DECLARE WAITQUEUE(wait, current); 
/加 入 等 待 队列 
add wait queue(&dev-^wq, &wait); 
set current state(TASK. INTERRUPTIBLE); 
for(;;)/ 不 断 查 询 数据 到 达标 识 


{ 
if(atomic read(&flag)==1)//flag==1 表示 数据 就 绪 
1 
break; 
} 
if (signal pending(currenb)J/ 查 看 是 否 有 信和 号 正 等 待 处 理 
1 
ret = -ERESTARTSYS; 
break; 
} 
schedule();// 主 动 调度 其 他 进程 
} 
set_current state(TASK RUNNING); 


remove wait queue(&dev->wq, &wait); 
if(ret)return ret; 
/获取 信和 号 量 
if (down interruptible(&dev->sem)) 

return -ERESTARTSYS; 
if (copy to user(buf,demoBuffer,count)) * 把 数据 写 到 应 用 程序 空间 */ 
{ 
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count--EFAULT; 
goto out; 
} 
atomic set(&flag ,0); 
Out: 
up(&dev->sem); 
return count; 


} 


ssize t simple write(struct file *filp, const char _ user *buf, size t count,loff t *f pos) 
{ 
struct simple dev *dev = filp->private_data; 
ssize t retval = -ENOMEM; 
if (down interruptible(&dev-^sem)) 
{ 
return -ERESTARTSYS; 
} 
if(copy from user(demoBuffer, buf, count)) { 
retval = -EFAULT; 
goto out; 
} 
up(&dev->sem); 
atomic set(&flag ,1);// 数 据 就 绪 
/唤醒 所 有 注册 到 该 等 待 队列 上 的 进程 
wake up interruptible(&dev->wq); 


return count; 
out: 

up(&dev-»sem); 

return retval; 


) 
运行 结果 与 上 一 版 本 一 样 。 
3.3.3 ”完成 事件 


完成 事件 〈completion) 是 一 种 轻 量 级 的 同步 机 制 ， 它 允许 一 个 进程 告诉 另 一 个 进程 某 
种 工作 已 经 完成 。 完 成 事件 是 基于 等 待 队列 的 。 完 成 事件 使 用 下 面 的 结构 描述 : 


struct completion { 
unsigned int done; /等 待 完成 的 事件 数量 
wait queue head t wait; 


js 
完成 事件 初始 化 函数 如 下 ; 


DECLARE COMPLETION(my comp); /静态 初始 化 
void init completion(struct completion *x); 动态 初始 化 完成 事件 


等 待 完 成 事件 的 函数 如 下 : 
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wait for completion(struct completion *x); 

/可 中 断 的 wait for completion 

wait for completion interruptible(struct completion *x); 

// 带 超时 处 理 的 wait for completion 

unsigned long wait for completion timeout(struct completion *x, unsigned long timeout); 


唤醒 等 待 进程 的 函数 包括 complete 和 complete all: 


complete(struct completion *x); /唤醒 一 个 等 待 完 成 事件 的 进程 
complete all(struct completion *); /唤醒 所 有 等 待 的 进程 。 


183.5 完成 事件 实例 
代码 见 \samples\3synchronous\3-6complete。 核 心 代码 如 下 : 


struct completion comp; 
int simple init module(void) 


{ 


init completion(&comp); 


} 
读 写 函数 代码 如 下 : 


ssize tsimple read(struct file *filp, char _ user *buf, size t count,loff t *f pos) 


{ 
wait_for_completion(&comp); 
printk("simple read: wait for completion"); 
return 0; 
j 
Ssize t simple write(struct file *filp, const char — user *buf, size t count,loff t *f pos) 
1 
complete(&comp); 
printk("simple write: complete Wn"); 
return count; 
} 


应 用 层 代 码 在 同一 目录 。 运 行 结果 如 下 : 


[root@/homel|#insmod demo.ko 
[root@/homel#mknod /dewfgj c 224 0 
[root@/home]#./read & 

302 

[root(2/home |? 
[root@/home]#./write 

DEMO write: complete 

DEMO read: wait_for_completion 
The data is 

[root@/home]# 
[root@/home]#./write 
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B 
Uu 
B 


DEMO write: complete 

DEMO read: wait for completion 
The data is 

[root(2/home |? 


3.4 通知 链 


Linux 内 核 分 为 多 个 子 系统 ， 但 这 些 子 系统 之 间 并 非 相互 独立 。 当 某 个 子 系统 中 的 某 个 
状态 发 生变 化 时 ， 有 时 候 需 要 通知 其 他 子 系统 做 出 相应 的 处 理 。 为 满足 这 种 需求 ， 内 核 出 现 
了 通知 链 (Notifier Chain) 机 制 。notifier block 结构 描述 一 个 通知 单元 ; 


typedef ^ int(*notifier fn t)(struct notifier block *nb,unsigned long action, void *data); 
struct notifier block { 

notifier fn t notifier call; 

struct notifier block — rcu *next; 


int priority; 
js 
通知 链 有 四 种 类 型 ， 分 别 是 原子 通知 链 、 可 阻塞 通知 链 、 原 始 通知 链 、SRCU 通知 链 : 


struct atomic notifier head { 
spinlock t lock; 
struct notifier block — rcu *head; 
je 
struct blocking notifier head ( 
struct rw semaphore rwsem; 
struct notifier block — rcu *head; 
n 
struct raw notifier head { 
struct notifier block — rcu *head; 
n 
struct Srcu notifier head { 
struct mutex mutex; 
struct srcu struct srcu; 
struct notifier block — rcu *head; 


5h 
原子 通知 链 的 回调 函数 在 中 断 或 原子 上 下 文中 运行 ， 不 允许 阻塞 。 可 阻塞 通知 链 的 回调 
函数 在 进程 上 下 文中 运行 ， 允 许 阻 塞 。 原 始 通知 链 不 限制 回调 运行 环境 ， 保 护 措施 由 调用 者 
自己 维护 。SRCU 通知 链 是 可 阻塞 通知 链 的 变种 ， 它 使 用 可 睡眠 的 RCU 机 制 (Sleepable 
Read-Copy Update) 而 不 是 rw-semaphores 来 保护 通知 链 。 这 四 种 通知 链 对 应 的 通知 单元 注册 
函数 如 下 : 
int atomic notifier chain register(struct atomic notifier head *nh,struct notifier block *nb); 


int blocking notifier chain register(struct blocking notifier head *nh,struct notifier block *nb); 
intraw notifier chain register(struct raw notifier head *nh,struct notifier block *nb); 


E 


int srcu notifier chain register(struct srcu notifier head *nh,struct notifier block *nb); 
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下 面 以 内 核 自 带 的 网 络 设备 通知 链 来 说 明 通 知 链 的 用 法 。 首 先 定义 一 个 通知 链 : 


static RAW_NOTIFIER_HEAD(netdev_chain); 


次 提供 一 个 网 络 设备 通知 链 注册 接口 以 及 一 个 状态 变化 通知 接 


int register netdevice notifier(struct notifier block *nb) 


1 


err = raw notifier chain register(&netdev chain, nb); 


j 


static int call netdevice notifiers info(unsigned long val,struct net device *dev, 


struct netdev notifier info *info) 


ASSERT RTNL(); 
netdev notifier info init(info, dev); 
return raw notifier call chain(&netdev chain, val, info); 


} 
int call netdevice notifiers(unsigned long val, struct net device *dev) 
1 
struct netdev notifier info info; 
return call netdevice notifiers info(val, dev, &info); 
j 


EXPORT SYMBOL(call netdevice notifiers); 


需要 接收 通知 的 模块 要 在 网 络 设备 通知 链 上 注册 通知 单元 ， 如 ARP 模块 的 通知 单元 注 
册 代 码 如 下 : 


static int arp netdev event(struct notifier block *this, unsigned long event,void *ptr) 
1 
struct net device *dev = netdev notifier info to _dev(ptr);// 获 取 网 络 设备 指针 
struct netdev notifier change info *change info; 
/区 分 网 络 设备 事件 ， 做 出 相应 处 理 
switch (event) { 
case NETDEV CHANGEADDR: 
neigh changeaddr(&arp tbl, dev); 
rt cache flush(dev net(dev)); 
break; 
case NETDEV CHANGE: 
change info = ptr; 
if (change info-^flags changed & IFF NOARP) 
neigh changeaddr(&arp tbl, dev); 


= 


break; 
default: 
break; 


j 
retum NOTIFY DONE; 
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static struct notifier block arp netdev notifier — ( 
.notifier call = arp netdev event, 


h 
void  initarp init(void) 
1 
register netdevice notifier(&arp netdev notifier); 
} 


需要 发 送 网 络 设备 通知 的 模块 会 调用 call netdevice notifiers， 在 网 络 设备 通知 链 上 注册 
过 的 通知 单元 的 回调 函数 都 会 被 调用 。 例 如 网 卡 MAC 地 址 变更 函数 : 


intdev set mac address(struct net device *dev, struct sockaddr *sa) 
1 
const struct net device ops *ops = dev-^netdev ops; 


int err; 


err = ops-^ndo set mac address(dev, sa); 
if (err) 

return err; 
dev->addr assign type = NET ADDR SET; 
call netdevice notifiers(:NETDEV CHANGEADDR, dev); 
add device randomness(dev-^dev addr, dev->addr len); 
return 0; 


j 
Linux 内 核 另 一 个 重要 的 通知 链 就 是 CPU 频率 通知 链 ，CPU 频率 通知 链 有 两 种 类 型 ， 


即 转变 通知 链 和 策略 通知 链 : 

#define CPUFREQ TRANSITION NOTIFIER (0) 
#define CPUFREQ POLICY NOTIFIER (1) 
/# 转 变通 知 链 状 

#define CPUFREQ PRECHANGE (0) 
#define CPUFREQ POSTCHANGE (1) 
PERRO ATHEN 

#define CPUFREQ ADJUST (0) 
#define CPUFREQ NOTIFY (1) 
define CPUFREQ START 2) 
#define CPUFREQ CREATE POLICY (3) 
#define CPUFREQ REMOVE POLICY (4) 


static BLOCKING NOTIFIER HEAD(cpufreq policy notifier list); 
static struct srcu notifier head cpufreq transition notifier list; 


注册 CPU 频率 通知 链 的 函数 为 : 


int cpufreq register notifier(struct notifier block *nb, unsigned int list); 


list 参数 就 是 CPU 频率 通知 链 类 型 。 
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Linux 内 核 代码 非常 庞 和， 主要 由 进程 调度 、 内 存 管理 、 虚 拟 文件 系统 、 网 络 子 系统 、 
进程 通信 、 设 备 管 理 等 儿 个 子 系统 组 成 ， 各 个 子 系统 相互 依赖 。 本 章 将 介绍 Linux 内 核 中 的 
内 存 管 poa 


4.4 物理 地 址 和 虚拟 地 址 


处 理 器 通过 地 址 来 访问 内 存 中 的 单元 ， 地 址 有 虚拟 地 址 和 物理 地 址 之 分 。 如 果 处 理 器 没 
^H MMU (Memory Management Unit， 内 存 管理 单元 )， 它 发 出 的 地 址 将 直接 传 到 处 理 器 芯片 
的 外 部 地 址 引 脚 上 ， 直 接 被 内 存 芯片 接收 ， 这 种 地 址 称 为 物理 地 址 。 如 果 处 理 器 启用 了 
MMU， 它 发 出 的 地 址 将 被 MMU 和 截获， 这 个 地 址 称 为 虚拟 地 址 。MMU 会 将 虚拟 地 址 映射 
成 物理 地 址 。 引 入 虚拟 地 址 到 物理 地 址 的 映射 会 给 分 配 和 释放 内 存 带 来 方便 ， 物 理 上 不 连续 
的 空间 可 以 映射 为 逻辑 上 连续 的 虚拟 地 址 空间 。 使 用 虚拟 地 址 可 以 简化 程序 的 链接 与 加 载 过 
程 ， 并 很 好 地 实现 进程 之 间 的 地 址 隔离 。 另 外 各 进程 分 配 的 内 存 之 和 可 能 会 大 于 实际 可 用 的 
物理 内 存 ， 虚 拟 内 在 管理 使 得 这 种 情况 下 各 进程 仍然 能 够 正常 运行 。 

32 位 系统 的 虚拟 地 址 总 大 小 为 4GB。Linux 将 这 4GB 虚拟 地 址 空间 分 为 两 个 部 分 ， 
3GB 为 用 户 空 间 ，3 一 4GB 为 内 核 空 间 。Linux 下 的 虚拟 地 址 相关 的 结构 和 函 


struct vm struct { 


struct vm struct *next; // 指 向 下 一 虚拟 地 址 ， 加 速 查询 
void *addr; /地 址 
unsigned long size; /大 小 
unsigned long flags; /标志 
struct page **pages; /页 指针 
unsigned int nr pages; 
phys addr t phys addr; // 物 理 地 址 
const void *caller; 

h 

I V FEBR DX 

struct vmap area ( 
unsigned long va start; /起 始 地 址 
unsigned long va end; /结束 地 址 


unsigned long flags; 

struct rb node rb node; 

struct list head list; /# 地 址 列表 *#/ 
struct list head purge list; 


struct vm struct *vm; 


struct rcu head rcu. head; 


D 


struct vm struct *alloc vm area(size tsize); /分 配 虚拟 地 上 
void free vm area(struct vm struct *area); /释放 虚拟 地 址 


MMU 将 虚拟 地 址 映射 到 物理 地 址 是 以 页 “Page) 为 单位 的 


页 为 4KB。 物 理 内 存 中 的 页 称 为 物 到 


Table) 来 记录 虚拟 地 址 页 面 与 物理 内 存 页 面 之 间 的 凤 


42 内存 分 配 与 释放 
同 printf 函数 一 样 ， 应 用 


的 内 存 申请 和 释放 函数 为 kmalloc 和 kfree， 其 原型 为 : 


void *kmalloc(size t size, gfp t flags) 


void *kzalloc(size tsize, gfp tflags);// 调 用 


void kfree(const void *x); 


章 “内存 管理 与 链表 


3m 
ES 


， 对 于 32 位 CPU， 通 常 一 


页 面 或 者 页 帧 (Page Frame)。MMU 使 用 页 表 (Page 
UNA 


zl] malloc 和 free 函数 不 能 在 内 核 态 使 用 。 在 内 核 态 ， 最 常用 


kmalloc 分 配 内 存 并 将 内 存 清 零 


Kmalloc 函数 分 配 的 地 址 空间 是 线性 映射 的 ， 它 一 般 用 来 分 配 小 于 128KB 的 内 存 。 
kmalloc 函数 分 配 的 内 存 必 须 用 kfree 函数 释放 。 参 数 size 为 申请 的 内 存 大 小 。 参 数 flags 的 
值 见 表 4-1。 

表 4-1 kmalloc 的 flags 参数 
参 数 值 E AN 备 È 
GFP KERNEK 运行 在 内 核 空间 的 进程 使 用 。 当 空闲 内 存 较 少 时 ， 可 能 使 用 GFP KERNEL 来 分 配 内 存 的 函数 必 
进入 休眠 来 等 待 一 个 页 面 须 是 可 重 入 ， 且 不 能 在 原子 上 下 文中 运行 
GFP_ATOMIC 原子 性 的 内 核 空间 分 配 。 进 程 不 能 被 置 为 睡眠 时 ， 应 使 | ”常用 来 从 中 断 处 理 和 进程 上 下 文 之 外 的 划 
= GFP ATOMIC 他 代码 中 分 配 内 存 ， 不 会 导致 睡眠 
GFP USER 为 用 户 空 间 分 配 内 存 页 可 能 导致 睡眠 
GFP HIGHUSER 类 似 GFP_USER， 如 果 有 高 端 内 存 ， 就 从 高 端 内 存 分 配 


GFP_NOIO 类 似 GFP_KERNEL。 但 禁止 任何 IO 初始 化 
GFP_NOFS 类 似 GFP_KERNEL。 但 不 允许 执行 任何 文件 系统 调 主要 用 于 文件 系统 


如 果 要 分 配 大 块 的 内 存 ， 应 使 用 面向 页 的 技术 。 面 向 页 内 存 分 配 函 数 如 下 : 


/返回 一 个 单个 的 ， 零 填充 的 页 。 


unsigned long get zeroed page(gfp t gfp mask); 


// 直 


接 获 取 整 页 的 内 存 〈 页 数 是 2 BO. 


unsigned long get free pages(gfp t gfp mask, unsigned int order); 


/释放 面向 页 分 配 的 函数 。 


void free pages(unsigned long addr, unsigned int order); 


如 果 要 申请 


是 连续 的 ， 但 是 映射 到 的 物理 内 存 是 不 连续 的 ， 而 且 可 


能 与 物 到 


片 连续 的 虚拟 内 存 ， 需 要 使 用 vmalloc 函数 。vmalloc 返回 


的 虚拟 内 存 虽 然 


地 址 不 是 一 一 对 应 的 《不 同 


T kmalloc 4! get free_pages)。 因 此 在 使 用 它 分 配 到 的 内 存 时 ， 页 表 的 查询 比较 频繁 ， 所 以 


效率 相对 较 低 。 申 请 连续 虚拟 内 存 的 函 


数 原型 如 下 : 


87 


Linux 驱动 程序 开发 实例 第 2 版 


void *vmalloc(unsigned long size); 
void *vmalloc user(unsigned long size) /为 用 户 空间 分 配 内 存 
void vfree(void *addr); /释放 由 vmalloc 分 配 的 内 存 


4.3 cache 


CPU 的 运行 速度 比 内 存 速度 快 很 多 ， 通 常 CPU 需要 等 待 内 存 的 响应 。 为 解决 这 个 问题 ， 
cache 诞生 了 。cache 即 高 速 缓存 ， 是 一 种 特殊 的 存储 器 ， 速 度 与 CPU 差不多 ， 能 极 大 提高 CPU 
的 效率 。Linux 内 核 使 用 slab 机 制 管理 cacheo kmem cache create 函数 用 来 创建 slab ZT: 


struct kmem cache *kmem cache create(const char *name, size t size, size t align, 
unsigned long flags, void (*ctor)(void *)); 


name 表示 所 创建 的 新 缓存 的 名 字 ，size 为 缓存 所 分 配对 象 的 大 小 ，align 为 对 和 象 的 对 齐 
值 ，flags 为 创建 标识 ，ctor 为 创建 cache 时 的 构造 函数 ， 可 以 为 NULL。 
kmem cache alloc 函数 从 cache 中 分 配 内 存 : 


void *kmem cache alloc(struct kmem cache *s, gfp t gfpflags); 


kmem cache free 函数 用 于 释放 cache Vy ff: 


void kmem cache free(struct kmem cache *cachep, void *objp); 


kmem cache destroy 函数 用 于 销毁 slab 缓存 ; 


void kmem cache destroy(struct kmem cache *s); 


4.4 IO 端口 到 虚拟 地 址 的 映射 


在 PowerPC, m68k 和 ARM 等 体系 中 ， 外 设 IO 端口 具有 与 内 存 一 样 的 物理 地 址 ， 外 设 
的 IO 内 存 资源 的 物理 地 址 是 已 知 的 ， 由 硬件 的 设计 决定 。Linux 的 驱动 程序 并 不 能 直接 通 
过 物理 地 址 访问 VO 内 存 资源 ， 而 必须 将 物理 地 址 映射 到 内 核 虚拟 地 址 空间 。 


4.4.1 静态 映射 


在 ARM 存储 系统 中 ， 使 用 内 存 管理 单元 (MMU) 实 现 虚拟 地 址 到 实际 物理 地 址 的 映射 。 
MMU 的 实现 过 程 ， 实 际 上 就 是 一 个 查 表 映射 的 过 程 。 建 立 页 表 是 实现 MMU 功能 不 可 缺少 
的 一 步 。 页 表 位 于 系统 的 内 存 中 ， 页 表 的 每 一 项 对 应 于 一 个 虚拟 地 址 到 物理 地 址 的 映射 。 每 

项 的 长 度 即 是 一 个 字 的 长 度 (在 ARM 中 ， 一 个 字 的 长 度 被 定义 为 4B)。 页 表 项 除 完成 虚拟 
地 址 到 物理 地 址 的 映射 功能 之 外 ， 还 定义 了 访问 权限 和 缓冲 特性 等 。 

Linux 内 核 的 create mapping 函数 就 是 用 来 创建 线性 映射 表 的 。 采 用 create mapping I 

数 建立 的 映射 是 静态 映射 方式 。 


路 


L 


struct map desc ( 
unsigned long virtual;// 虚 拟 地 址 
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unsigned long pfn;/ phys to pfn(phy addr) 
unsigned long length;// 长 度 
unsigned int type;// 类 型 MT_DEVICE、MT_MEMORY 等 


is 


void  initcreate mapping(struct map desc *md); 


ARM 平台 下 使 用 iotable init 来 创建 平台 专用 的 映射 : 


em 


void  initiotable init(struct map desc *io desc, int nr); 


例如 S3C6410X 平台 的 启动 代码 中 的 内 存 映 射 如 下 : 


static struct map desc smdk6410 iodesc[] = 全 /需要 建立 的 映射 在 此 添加 
s3c64xx init io(smdk6410 iodesc, ARRAY SIZE(smdk6410 iodesc)); 
void init s3c64xx init io(struct map desc *mach desc, int size) 


1 


lotable init(s3c iodesc, ARRAY SIZE(s3c iodesc)); 
lotable init(mach desc, size); 


j 


4.4.2 ioremap 


如 果 需 要 在 模块 中 动态 映射 IJO， 可 以 采用 ioremap PAZ. K% ioremap 用 来 将 VO 内 存 
资源 的 物理 地 址 映射 到 核心 虚拟 地 址 空间 。ARM 体系 下 的 ioremap 函数 原型 如 下 : 


typedef phys addr tresource size t; 


void  iomem *ioremap(resource size tres cookie, size t size); 


res cookie 为 物理 地 址 ，size 为 地 址 空间 大 小 。ioremap 函数 返回 映射 后 的 虚拟 地 址 。 
取消 ioremap 所 做 的 地 址 映射 应 使 用 iounmap 函数 : 


void iounmap(volatile void __iomem *iomem cookie); 


例 4.1 ioremap 映射 实例 
代码 见 \samples4memoryM-lioremap。 核 心 代码 如 下 : 


static int mem start = 101, mem size = 10; 
static char *reserve virt addr; 
static int major; 


int init moduleiomap(void) 


1 
if ((major = register chrdev(0, "mmapdrv", &mmapdrv fops)) < 0) 
1 
printk("mmapdrv: unable to register character device n"); 
return ( - EIO); 
j 


printk("mmap device major = %d\n", major); 


/物理 地 址 映射 到 核心 虚拟 地 址 空间 
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j 


reserve virt addr = 10remap(mem start *1024 * 1024, mem size *1024 * 1024); 
printk("reserve virt addr = 0x%lx\n", (unsigned long)reserve virt addr); 


if(reserve virt addr) 


1 
int i; 
for (1— 0; i< mem size *1024 * 1024; i += 4) 
{ 
reserve_virt_addr[i] = 'a'; 
reserve_virt_addr[i + 1] — 'b'; 
reserve virt addr[1 + 2] = 'c*; 
reserve virt addr[i +3] — 'd'; 
} 
} 
else 
{ 
unregister chrdev(major, "mmapdrv"); 
return - ENODEV; 
} 
return 0; 


本 例 把 从 101MB 开始 的 10MB 物理 地 址 空间 映射 到 虚拟 地 址 空间 ， 运 行 结果 如 下 ; 


[root@urbetter drivers | insmod ioremap.ko 


mmap device major = 252 
reserve virt addr — 0xc9000000 


4.5 ”内 核 空间 到 用 户 空 间 的 映射 


45.1 mmap 接口 
在 内 核 中 将 内 核 地 址 映射 到 用 户 地 址 之 后 ， 应 用 程序 可 以 下 


mmap 操作 。mmap 最 典型 的 应 用 就 是 在 framebuffer 驱动 ! 
存 。 文 件 操作 结构 file operations 的 mmap 接口 就 是 用 来 进行 这 种 地 址 时 


[ 接 访 问 内 核 地 址 ， 这 就 是 


应 


mmap， 驱 动 必须 实现 mmap 接口 : 


int (*mmap) (struct file *, struct vm area struct *); 


内 核 中 的 remap pfn range 函数 用 于 将 内 核 地 址 外 


用 程序 可 以 直接 操作 显卡 绥 


UB). AU IA 


射 到 用 户 地 址 ; 


int remap pfn range(struct vm area struct *vma, unsigned long addr,unsigned long pfn, 


其 中 参数 vma 是 用 户 空 间 传递 过 来 的 映射 参数 。 参 数 addr 表示 目标 用 户 


unsigned long size, pgprot t prot); 


始 地 址 。pfn 


为 内 核 物理 地 址 ， 确 切 地 说 应 该 是 虚拟 地 址 应 该 映射 到 的 物理 地 址 的 页 面 号 ， 实 际 上 就 是 物 


里 地 址 右 移 PAGE SHIFT 位 。size XHW 


UR X^. prot 为 新 页 所 要 求 的 保护 属 怕 


kmalloc 申请 的 内 存 映 射 到 用 户 空 间 ， 通 常 要 把 相应 的 内 存 设 置 为 保留 。 
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4.5.2. mmap 系统 调用 

应 用 程序 通过 内 存 映射 可 以 直接 访问 设备 的 IO 存储 区 或 DMA 缓冲 。 内 存 映 射 使 用 户 
空间 的 一 段 地 址 关联 到 设备 内 存 上 ， 程 序 在 映射 的 地 址 范围 内 进行 读 取 或 者 写 入 ， 实 际 上 就 
是 对 设备 的 访问 。mmap 系统 调用 的 原型 如 下 : 


unsigned long mmap (unsigned long addr, unsigned long len, int prot, int flags, int fd, long off); 


addr 是 内 存 块 的 建议 位 置 ， 不 能 确保 mmap0 函 数 就 一 定 使 用 这 块 内 存 区 域 ， 因 此 通常 
将 其 设置 成 NULL。len 是 映射 到 调用 进程 地 址 空间 的 字 节 数 ， 它 从 被 映射 文件 开头 off 个 字 
节 开 始 算 起 。prot 参数 指定 共享 内 存 的 访问 权限 。 可 取 如 下 几 个 值 : PROT READ CJ), 
PROT WRITE《〈 可 写 )、PROT EXEC《〈 可 执行 )、PROT NONE (不 可 访问 )。flags 由 以 下 
几 个 常 值 指定 ， MAP SHARED. MAP PRIVATE. MAP FIXED。 其 中 ，MAP SHARED 和 
MAP PRIVATE 必 选 其 一 ， 而 MAP FIXED 则 不 推荐 使 用 。 如 果 指 定 为 MAP SHARED， 则 
对 映射 的 内 存 所 做 的 修改 同样 影响 到 文件 。 如 果 是 MAP_PRIVATE， 则 对 映射 的 内 存 所 做 的 修 
改 仅 对 该 进程 可 见 ， 对 文件 没有 影响 。fqd 是 设备 的 文件 描述 符 。off 参数 一 般 设 为 0， 表 示 从 
文件 头 开 始 映射 。 不 是 所 有 的 设备 都 可 以 进行 mmap 映射 ， 如 串口 和 面向 流 的 设备 就 不 可 以 。 

如 果 应 用 程序 要 取消 mmap 建立 的 映射 ， 可 以 使 用 munmap 函数 : 


int munmap(void *addr, size t len); 


例 4.2. mmap 驱动 程序 实例 
代码 见 \samples\4memory4-2mmap。 核 心 代码 如 下 ;: 


struct file operations mmapmem fops = 1 


.owner = THIS MODULE, 
open = mmapmem open, 
.mmap- . mmapmem mmap, // mmap 接口 
release - mmapmem release, 
h 
在 初始 化 时 分 配 内 存 ， 代 码 如 下 : 
static char*buffer-NULL; 


static char*buffer area- NULL; 

buffer = kmalloc(MAP BUFFER SIZE,GFP KERNEL); 

printk(" mmap buffer = ?op Wn", buffer); 

buffer area-(int *)(((unsigned long)buffer + PAGE SIZE -1) & PAGE MASK); 

for (virt addr-(unsigned long)buffer area; 

virt addr«(unsigned long)buffer area- MAP BUFFER SIZE;virt addr-—PAGE SIZE) 
1 


SetPageReserved(virt to page(virt addr)); K VL EE N DR ER */ 


j 
memset(buffer,,MAP BUFFER SIZE); 


mmapmem mmap 函数 实现 mmap 文件 接 
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static int mmapmem mmap(struct file *filp, struct vm area struct *vma) 


1 
int ret; 
ret = remap pfn range(vma,vma-^vm start, 
virt to phys((void*)((unsigned long)buffer area)) >> PAGE SHIFT, 
vma-»vm end-vma-»vm start, PAGE SHARED); 
if(ret != 0) { 
return -EAGAIN; 
j 
return 0; 
j 


于 将 虚拟 地 址 转换 为 物理 地 址 。 测 试 程序 参考 代码 如 下 : 


pann 


virt_to_phys 函数 


int main(void) 
i 
int fd; 
char *addr-NULL; 
fd = open("/dev/mmap",O RDWR); 
if(fd « 0) 
1 
perror(" open"); 
return 1; 
j 
addr = mmap(NULL, 4096, PROT READ|PROT WRITE, MAP SHARED, fd, 0); 
if(addr — MAP FAILED) 
1 
perror("mmap"); 
return 1; 
j 
memset(addr,0,101); 
printf(" 96s", addr); 
sleep(2); 
memset(addr,'f,, 100); 
addr[0]- p'; 
printf(" 96s", addr); 
munmap(addr,4096); 
addr-NULL; 
close(fd); 
/再 次 打开 验证 刚才 的 修改 
fd = open("/dev/mmap",O RDWR); 
if(fd « 0) 
1 


perror("open"); 
return 1; 


j 
addr = mmap(NULL, 4096, PROT READIPROT WRITE, MAP SHARED,.fd, 0); 
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if(addr == MAP FAILED) 
1 
perror("mmap"); 
return 1; 
j 
printf(" 96s", addr); 
munmap(addr,4096); 
close(fd); 
return(0); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter drivers]# insmod mapmem kmalloc.ko 
mmap buffer = c6800000 

[root@urbetter drivers |? mknod /dev/mmap c 224 0 

[root(a)urbetter drivers]? ./test 
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pfFEFFEFEFFEEEEFEFFEFEEFEFEFEETETFEEETTTETEFEEEEFETEEETETEFTETEFEFEEEFEEEFEETEFEETEFTETTETETEEETETETE 
pfFEFFEFEFFEEEFFEFFEFEFFEFEFFETEFEEEFTTEEEEFETEFEETEFTETEFTETEFEFEEEFEFEFEETEFTETEFTETTETETEETEETETE 


4.6 DMA 映射 


DMA 即 直 接 内 存 访问 (Direct Memory Access)， 是 一 种 无 需 CPU 干预 的 数据 传输 方式 。 
这 种 数据 传输 方式 不 仅 速度 快 ， 并 且 可 以 不 消耗 CPU， 目 前 在 很 多 外 设 中 使 用 。Linux 内 核 


提供 了 两 种 DMA 内 存 映射 函数 : 


void *dma alloc coherent(struct device *dev, size t size,dma addr t *dma handle, gfp t flag); 
void *dma alloc noncoherent(struct device *dev, size t size,dma addr t *dma handle, gfp t gfp); 


dma alloc coherent 用 来 建立 一 致 性 DMA 映射 。dma_alloc_noncoherent 用 来 建立 非 一 致 
性 DMA 映射 。 一致 性 内 存 确保 处 理 器 与 设备 之 间 看 到 的 数据 是 一 致 的 。 当 系统 中 存在 
cache， 特 别 是 多 个 cache 时 ， 一 个 数据 将 会 有 多 个 副本 ， 导 致 数据 的 一 致 性 难以 保证 。 例 如 


pp 


同一 个 数据 可 能 既 存放 在 cache 中 ， 也 存放 在 主 内 存 中 ， 假 如 这 两 


P^ 


个 地 方 的 值 不 相同 ， 就 说 


明 数 据 不 一 致 。 如 果 DMA 地 址 与 cache 地 址 有 重 登 ， 可 能 会 导致 传输 错误 。 在 ARM 体系 


H, dma alloc_coheren 会 禁用 页 表 的 Cacheable 项 与 Bufferable 项 ， 以 确保 DMA 内 存 的 一 


致 性 。 


4.7 ”内核 链表 


47.1 Linux 内 核 中 的 链表 


Linux 内 核 中 的 链表 为 双向 链表 ， 双 向 链表 可 以 从 两 个 方向 遍历 。 


struct list head { 
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struct list head *next, *prev; 
5h 
e 链表 初始 化 


static inline void INIT LIST HEAD(struct list head *list) 
1 


list-^next = list; 
list->prev = list; 


j 
INIT LIST HEAD 函数 会 初始 化 一 个 空 链表 ， 并 把 链表 的 next. prev 指针 都 初始 化 为 指 
问 自己 。 
@ 链表 表 头 插入 


static inline void list add(struct list head *new, struct list head *head) 


1 


. list add(new, head, head-^next); 


j 
e 链表 表 尾 插入 


static inline void list add tail(struct list head *new, struct list head *head) 


1 


. list add(new, head->prev, head); 


j 
e 删除 链表 元 素 


static inline void list del(struct list head *entry) 


1 
. list del(entry-prev, entry->next); 
entry-^next = LIST POISONI; 
entry-^prev = LIST POISON2; 

} 


e 链表 搬移 


static inline void list move(struct list head *list, struct list head *head) 


1 
. list del(list-^prev, list-^next); 
list add(list, head); 

} 


list move 函数 用 来 将 链表 元 素 list 搬移 到 另 一 个 链表 中 。 
e ERT AR 


static inline void list replace(struct list head *old,struct list head *new) 


1 
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new-»next = old->next; 
new->next->prev = new; 
new->prev = old->prev; 
new->prev->next = new; 


} 
e 链表 遍历 


#define list first entry(ptr, type, member) \ 
list entry((ptr)-^next, type, member) 
#define list for each(pos, head) V 
for (pos = (head)-^next; prefetch(pos-^next), pos != (head); V 
pos = pos-^next) 
#define list for each entry(pos, head, member) 
for (pos = list entry((head)-^next, typeof(*pos), member); V 
prefetch(pos-^member.next), &pos-^-member !- (head); 
pos = list entry(pos-^member.next, typeof(*pos), member)) 


47.23 “内核 链表 实例 
例 4.3 ”内核 链表 实例 


第 


\ 


4 


章 


内 存 管理 与 链表 


代码 见 目 录 \samplesMmemory\4-3list。 本 例 演 示 链 表 的 节点 从 表 尾 插入 与 链表 遍历 。 核 


心 代码 如 下 : 


struct simplelist 
{ 
struct list head node; 
char buffer; 
h 
LIST HEAD(mylist); 
static int demo module init(void) 
1 
int i70; 
printk("demo module initin"); 
for(i=0;i<5;i++) 


{ 


struct simplelist*p=(struct simplelist *)kmalloc(sizeof(struct simplelist),GFP KERNEL); 


p->buffer=0x31+; 
list add tail(&p->node,&mylist); 
} 
struct simplelist* slistp; 
list for each entry(slistp,&mylist,node){ 
printk("find a list buffer is ocn" slistp-^buffer); 
} 


return 0; 


j 


static void demo module exit(void) 
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printk("demo module exitn"); 
} 
module init(demo module init); 
module exit(demo module exit); 


运行 结果 如 下 : 


[root@urbetter /homel# insmod smodule.ko 
demo module init 

find a list buffer is 1 

find a list buffer is 2 

find a list buffer is 3 

find a list buffer is 4 

find a list buffer is 5 


例 4.4 内核 链 表 实例 二 


代码 见 目录 \samplesdmemoryM-4module listhead。 本 例 演示 链表 的 节点 从 表 头 插入 与 链 
表 人 遍历 、 链 表 节 点 删除 等 。 核 心 代码 如 下 : 


struct buffer head test 
int iflag; 
struct list head bh list; 

je 

struct buffer head test a; 

static int —initlist head init(void) 

1 
struct buffer head test * bhg- NULL; 
struct buffer head test * p-NULL; 
struct list head *pos; 
int i-0; 
/初始 化 链表 
INIT LIST HEAD(&a.bh list); 
forG=0;i<S;i++) 


1 
bhg-kmalloc(sizeof(struct buffer head test), GFP KERNEL); 
if(bhg==NULL) return -1; 
bhg->iflag=i; 
list add(&bhg->bh list,&a.bh list); 
j 


printk("list head init ok Wn"); 
list for each(pos,&a.bh lisb/ 遍 历 元 素 


1 
p-list entry(pos, struct buffer head test, bh list); 
printk("initfind the %d list element Wn" ;p-^iflag); 
j 
return 0; 
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} 
static void — exit list head exit(void) 
1 
struct buffer head test * p-NULL; 
struct buffer head test * from, "scratch; 
struct list head *pos; 
/退出 时 清理 链表 
list for each entry safe(from,scratch,&a.bh list,bh list) 
1 


printk("del the %d list element\n",from->iflag); 
list del(&from-^bh list); 
kfree(from); 
j 
/验证 删除 结果 
list for each(pos,&a.bh list) 
1 


p-list entry(pos, struct buffer head test, bh list); 
printk("delfind the %d list element n", p-iflag); 


j 
本 例 运 行 结果 如 下 : 


[root@urbetter drivers]# insmod hello.ko 
list head init ok 

initfind the 4 list element 

initfind the 3 list element 

initfind the 2 list element 

initfind the 1 list element 

initfind the 0 list element 
[root(Qyurbetter drivers |? rmmod hello 
del the 4 list element 

del the 3 list element 

del the 2 list element 

del the 1 list element 

del the 0 list element 
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任务 与 调度 


Linux 是 一 个 多 任务 多 线程 操作 系统 。 任 务 调度 是 Linux 内 核 的 核心 功能 之 一 。 另 外 很 
定 的 延迟 机 制 来 延迟 代码 的 执行 。 本 章 介 绍 内 核 线 程 、 定 


多 时 候 由 于 资源 尚未 就 绪 ， 和 需要 一 
时 器 、 延 迟 处 理 机 制 等 内 容 。 


5.1 schedule 


Linux 进程 的 状态 包括 如 下 类 型 


#define TASK RUNNING 0/ 运 行 中 
define TASK INTERRUPTIBLE MAEA np 
define TASK UNINTERRUPTIBLE 2/ 等 竺 中， 不 
define  TASK STOPPED 4 

define  TASK TRACED 8 

/*in tsk->exit_state*/ 

#define EXIT_DEAD 16// 死 亡 
#define EXIT ZOMBIE 32// 伪 死 


#define EXIT TRACE 

/*in tsk->state again*/ 
#define TASK DEAD 
#define TASK WAKEKILL 
#define TASK WAKING 
#define TASK PARKED 
#define TASK NOLOAD 
#define TASK STATE MAX 


以 被 信号 唤醒 
可 以 被 信号 唤醒 ，wakeup 才能 唤醒 


(EXIT ZOMBIE | EXIT DEAD) 


64 
128 
256 
512 
1024 
2048 


Linux 进程 在 等 待 资源 就 绪 的 过 程 中 ， 可 以 主动 让 
可 以 调用 schedule 函数 来 让 出 CPU， 进 程 被 唤醒 后 将 从 


醒 后 继续 检测 资源 是 否 就 绕 。 进 程 
schedule 函数 的 下 一 条 代码 开始 执 和 


void sched schedule(void) 


Ts 


上 CPU， 自身 进入 睡眠 状态 ， 等 待 唤 


signed long sched schedule timeout(signed long timeout)// 带 超时 的 调度 


失败 。 假 设 进程 A 等 待 链表 数据 ， 其 代码 如 下 ;: 


这 个 过 程 特别 要 注意 避免 唤醒 


/Process A: 

spin lock(&list lock); 

if(list empty(&list head)) { 
spin unlock(&list lock); 


set current state(TASK INTERRUPTIBLE); 
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schedule(); 

spin lock(&list lock); 
j 
spin unlock(&list lock); 


而 进程 B 生产 数据 ， 并 将 数据 插入 链表 ， 唤 醒 等 待 进程 A， 代 码 如 下 : 


/Process B: 

spin lock(&list lock); 

list add tail(&list head, new node); 
spin unlock(&list lock); 

wake up process(processA); 


假设 进程 A 运行 到 第 3 行 后 ， 进 程 B 正好 运行 到 唤醒 函数 ， 此 时 A 尚未 睡眠 ， 所 以 错 
过 B 的 唤醒 ， 并 继续 往 下 进入 睡眠 。 这 可 能 会 导致 进程 A 只 能 等 待 进程 B 再 次 调用 唤醒 函 
数 才 能 唤醒 。 假 如 进程 B 不 再 调用 唤醒 函数 ， 则 进程 A 可 能 会 一 直 有 睡眠 下 去 。 所 以 修订 进 
FE A 代码 为 : 


/Process A: 
set current state(TASK INTERRUPTIBLE); 
spin lock(&list lock); 
if(list empty(&list head)) { 
spin unlock(&list lock); 
schedule(); 
spin lock(&list lock); 
} 
set_current state(TASK RUNNING); 
spin unlock(&list lock); 


这 样 进程 A 检测 链表 之 前 就 处 于 TASK INTERRUPTIBLE 状态 ， 假 如 进程 A 运行 到 第 4 
fri. B 调用 唤醒 函数 ， 会 将 进程 A 的 状态 变 成 TASK RUNNING， 则 进程 A 调用 schedule 
函数 不 会 进入 睡眠 。 读 者 可 以 回头 看 看 第 3 章 的 阻塞 式 读 的 例 程 代 码 ， 理 解 会 更 透彻 。 


5.2 ”内 核 线程 


内 核 线程 是 运行 在 内 核 态 的 线程 ， 一 般 用 来 完成 一 些 周期 性 的 任务 。 创 建 内 核 线程 使 用 
kthread create 函数 : 


struct task struct *kthread create(int (*threadfn)(void *data),void *data,const char namefmt[],...); 
threadfn 为 线程 函数 。data 和 namefmt 为 传递 给 线程 的 参数 。kthread create. 函数 创建 的 


线程 不 会 马上 运行 ， 要 使 用 wake up process 函数 唤醒 ，kthread run 宏 完成 了 kthread create 
Lj wake up process 两 步 ， 其 定义 如 下 : 


/创建 并 唤醒 一 个 线程 
#define kthread run(threadfn, data, namefmt, ...) \ 
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G \ 
struct task struct * Kk \ 
= kthread create(threadfn, data, namefmt, ## VA ARGS );\ 
if(IIS ERR( k)) N 
wake up process( Kk); N 
—k N 
39) 


kthread stop 函数 用 来 结束 内 核 线 程 : 


int kthread stop(struct task struct *k); 


在 调用 kthread stop 函数 时 ， 应 该 确保 线程 函数 threadfn 尚未 结束 运行 ， 否 则 
kthread stop 函数 会 一 直 等 待 。 

例 $.1 内 核 线程 实例 

本 例 实 现 一 个 基本 的 内 核 线程 。 代 人 码 见 \samples\Sschedule\S-1kthread。 核 心 代 码 如 下 : 


static struct task struct *simple thread; 
int threadfunc(void *data) 


1 
while(1) 
1 
set current state(TASK UNINTERRUPTIBLE);/ 设 置 线程 状态 为 不 可 被 信号 唤醒 
if(kthread should stopO)Jbreak:/ 检 查 线 程 是 否 应 该 退出 
printk("threadfunc n"); 
schedule timeout(HZ);/ 主 动 调度 ， 进 入 等 待 ， 直 到 超时 
} 
return 0; 
} 
void simple cleanup module(void) 
{ 
if(simple thread) 
{ 
// 停 止 内 核 线程 
kthread stop(simple thread); 
simple thread = NULL; 
} 
} 
/模块 初始 化 
int simple init module(void) 
1 
int err; 


simple thread = kthread run(threadfunc, NULL, "simple_thread");// 创 建 内 核 线程 并 唤醒 
if(IS ERR(simple thread)) 
1 
printk("kthread create failed. 1"); 
err = PTR. ERR(simple thread); 
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simple thread = NULL; 


return err; 


j 


return 0; 


module init(simple init module); 


module exit(simple cleanup module); 


本 例 运 行 结果 如 下 : 


[root@urbetter /homel# insmod kthreaddemo.ko 
[root(Q)urbetter /home|#threadfunc 


threadfunc 
threadfunc 
threadfunc 
threadfunc 
threadfunc 
threadfunc 
threadfunc 
threadfunc 


[root(Q)urbetter /homel#ps 


PID USER VSZ STAT COMMAND 
] root 3104 S init 

1089 root 3104 S init 
1091 root 3104 S init 
1092 root 3104 S init 
1109 root 8708 S< /opt/Otopia/bin/qss 
1110 root 13552 SN /Jopt/Otopia/bin/quicklauncher 
1138 root 1552 R ./test 
1147 root 0DW:« [simple thread] 


1148 root 3428 R ps 


5.3 ”内 核 调用 应 用 程序 


内 核 态 可 以 使 用 call usermodehelper 函数 调用 应 用 程序 : 


int call usermodehelper(char *path, char **argv, char **envp, int wait); 


call usermodehelper 函数 实际 上 


struct subprocess info { 
struct work struct work; 


中 path 为 程序 路 径 ; argv 为 参数 ，envp 为 环境 变量 ，wait 参数 为 是 否 等 待 结束 标志 。 


调用 了 call usermodehelper exec 函数 。 


struct completion *complete; 


char *path;// 路 径 
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char **argv;// Zt 
char **envp;// 环 境 变 量 


int wait;// 是 否 等 待 结束 


p 


int retval; 
int (*init)(struct subprocess info *info, struct cred *new); 
void (*cleanup)(struct subprocess info *info); 
void *data; 
h 


int call usermodehelper exec(struct subprocess info *sub info, int wait); 


例 $.2 ”内 核 启动 应 用 程序 实例 
本 例 实现 在 内 核 态 启动 应 用 程序 。 
具体 代码 见 \samples\Sschedule\5-2module call usermodehelper。 核 心 代 码 如 下 : 


static int demo module init(void) 


1 
int ret; 
char *argv[5], *envp[3]; 
argv[0] = "/bin/mkdir"; /程序 路 径 
argv[1] = "home/a/a"; /参数 
argv[2]=NULL; 
argv[3] = NULL; 
argv[4] = NULL; 
envp[0] = "HOME-/"; /环境 变量 设置 
envp[1] = "PATH-/sbin:/bin:/usr/sbin:/usr/bin"; 
envp[2] = NULL; 
ret = call usermodehelper(argv[0], argv, envp, UMH WAIT PROC); 
if (ret < 0) { 
printk(KERN ERR"Error %d running user helper " 
"V9 5s %s Vos Vos V n",ret, argv[0], argv[1], argv[2], argv[3]); 
} 
return 0; 
} 


运行 结果 如 下 : 


[root@urbetter al# pwd 

/home/a 

[root(Qurbetter al# ls 

[root@urbetter al# insmod /home/drivers/smodule.ko 
root@urbetter al# ls 

a 

[root@urbetter a]# 


可 见 加 载 模块 后 创建 了 一 个 目录 。 
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5.4 软 中 断 机 制 


5.4.1 fpc 


硬件 中 断 是 硬件 产生 的 中 断 信号 ， 软 中 断 是 软件 模拟 的 中 断 。 硬 件 产生 中 断后 ， 会 将 中 
HAZ; CPU, CPU 查询 向量 表 将 中 断 映射 成 具体 的 服务 程序 。 软 中 断 完全 在 操作 系统 内 
部 实现 ， 内 核 运行 一 个 守护 线程 来 实现 中 断 查 询 与 执行 ， 这 个 线程 的 功能 类 似 于 处 理 器 的 中 
断 控制 器 功能 。 构 成 软 中 断 机 制 的 核心 元 素 包 括 : 软 中 断 状态 (soft interrupt state). 软 中 断 
HEK Csoftirq vec)、 软 中 断 线程 (softirq thread)。 软 中 断 机 制 的 实现 原理 如 图 5-1 所 示 。 


run_ksoftirqd 内 核 线程 


void(*action) 


IR— ——————— nÓ——ÁNÜ 
= 软 中 断 向 量 表 
a 


图 5-1 Linux P HJP WNL 


c 


Linux 下 的 软 中 断 机 制 在 Linux 内 核 代 码 的 /kernel/softirq.c 中 实现 。 软 中 断 的 行为 用 
softirq_action 描述 。 软 中 断 存放 在 软 中 断 向 量 表 中 。Linux 4.5 内 核 目 前 最 多 可 以 有 10 种 软 
中 断 ， 包 括 定 时 器 、 网 络 软 中 断 、tasklet 等 。 


struct softirq action 


1 


void (*action)(struct softirq action *); 
h 
static struct softirq action softirq vec[|NR. SOFTIRQS]  cacheline aligned in smp; //$K =F Wf Je] =Œ: 
系统 在 ksoftirqd 内 核 进程 中 调用 ”do_softirq 循环 检测 软 中 断 是 否 处 于 pending 状态 ， 如 
果 是 ， 则 执行 相应 的 处 理 函数 。 


asmlinkage __visible void — do softirq(void) 

1 
unsigned long end = jiffies + MAX SOFTIRQ TIME; 
unsigned long old flags = current->flags; 
int max restart = MAX SOFTIRQ RESTART; 
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struct softirq action *h; 
bool in hardirq; 
. u32 pending; 
int softirq. bit; 
current-^flags &= —PF MEMALLOC; 
pending = local softirq pending(); 
account irq enter time(current); 
local bh disable ip( RET IP , SOFTIRQ OFFSET); 
in hardirq = lockdep softirq start(); 


restart: 
入 在 使 能 中 断 前 复位 pending $&83*/ 
set Softirq pending(0); 


local irq. enable(); 
h-softirq vec; 
while ((softirq bit = ffs(pending))) 1 
unsigned int vec nr; 
int prev count; 
h += softirq bit - 1; 
vec nr—-h- softirq vec; 
prev count = preempt count(); 
kstat incr softirgs this cpu(vec nr); 


trace softirq entry(vec nr); 
h->action(h);// 调 用 软 中 断 函 数 
trace softirq exit(vec nr); 
if (unlikely(prev count != preempt count())) { 
pr err("huh, entered softirq %u Vos %p with preempt count %08x, exited with 9008x? Ww", 
vec nr, softirq to name[vec nr], h->action, 
prev count, preempt count()); 
preempt count set(prev count); 


j 

h+; 

pending >>= softirq_bit; 
} 
rcu bh qs); 


local irq disable(); 
pending = local softirq pending(); 
if (pending) { 

if (time before(Jiffies, end) && !need resched() && 

--max restart) 
goto restart; 

wakeup softirqd(); 
} 
lockdep softirq end(in hardirq); 
account irq exit time(current); 
. local bh enable(SOFTIRQ OFFSET); 
WARN ON ONCE(in interrupt()); 
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tsk restore flags(current, old flags, PF MEMALLOC); 
j 


Linux 内 核 中 定义 了 下 列 软 中 断 优先 级 : 


enum 

{ 
HI SOFTIRQ=0, // 高 优先 软 中 断 
TIMER SOFTIRQ, // 定 时 器 
NET TX SOFTIRQ, /网 络 发 送 
NET RX SOFTIRQ, /网 络 接收 
BLOCK SOFTIRQ, // 块 层 设备 


IRQ POLL SOFTIRQ, 
TASKLET SOFTIRQ, // TASKLET 


SCHED SOFTIRQ, /调度 
HRTIMER SOFTIRQ, 
RCU SOFTIRQ, /*RCU 中 断 */ 


NR. SOFTIRQS 
js 


表 5-1 为 各 种 软 中 断 的 优先 级 与 处 理 函数 。 


de 5-1 各 种 软 中 断 的 优先 级 与 处 理 函 数 


软 中 断 优先 级 处 理 函 数 
HI SOFTIRQ 0 tasklet hi action 
TIMER SOFTIRQ 1 run timer softirq 
NET TX SOFTIRQ 2 net tx action 
NET RX SOFTIRQ 3 net rx action 
BLOCK SOFTIRQ 4 blk done softirq 
IRQ POLL SOFTIRQ 5 irq poll softirq 
TASKLET SOFTIRQ 6 tasklet action 
SCHED SOFTIRQ 7 run rebalance domains 
HRTIMER SOFTIRQ 8 run hrtimer softirq 
RCU SOFTIRQ 9 rcu process callbacks 


内 核 在 软 中 断 子 系统 初始 化 时 启动 了 tasklet 与 高 优先 软 中 断 : 


void  initsoftirq init(void) 
1 
int cpu; 
for each possible cpu(cpu) ( 
per cpu(tasklet vec, cpu).tail — 
&per cpu(tasklet vec, cpu).head; 
per cpu(tasklet hi vec, cpu).tail — 
&per cpu(tasklet hi vec, cpu).head; 
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启动 tasklet 与 高 优先 软 中 断 
open softirq(TASKLET SOFTIRQ, tasklet action); 
open softirq(HI SOFTIRQ, tasklet hi action); 


j 
5.4.2  tasklet 


软 中 断 是 利用 软件 模拟 的 中 断 机 制 ， 常 用 来 执行 异步 任务 。tasklet 是 利用 软 中 断 实现 的 


一 种 下 半 部 机 制 。tasklet 结构 体 定义 如 下 : 


struct tasklet struct 


1 
structtasklet struct *next; 。/* 队 列 指针 */ 
unsigned long state; /*tasklet 的 状态 */ 
atomic t count; 人 # 引 用 计数 ， 通 常用 1 表示 disabled*/ 
void (*func)(unsigned long); /执行 函 数 指针 尖 / 
unsigned long data; 
h 


tasklet 初始 化 函数 如 下 : 


void tasklet init(struct tasklet struct *t,void (*func)(unsigned long), unsigned long data); 
#define DECLARE TASKLET(name, func, data) 


调度 tasklet 使 用 tasklet schedule 函数 : 


void tasklet schedule(struct tasklet struct *t); 
void tasklet hi schedule(struct tasklet struct *t); /和 tasklet schedule 类 似 ， 优 先 级 更 高 


使 用 tasklet kill 函数 可 删除 tasklet: 


void tasklet kill(struct tasklet struct *t); 


如 果 tasklet 正在 运行 , tasklet kill 函数 将 等 待 直到 它 执行 完毕 。 
使 能 和 禁止 tasklet 的 函数 如 下 : 


/禁止 tasklet 被 tasklet schedule 调度 ， 如 果 该 tasklet 当前 正在 执行 ， 这 个 函数 会 等 至 


长 
H 
[ad 


void tasklet disable(struct tasklet struct *t); 

/和 tasklet disable 类 似 ， 但 是 它 不 等 待 tasklet 执行 完 就 返回 。 
void tasklet disable nosync(struct tasklet struct *t); 
/使 能 一 个 之 前 被 disable 的 tasklet 

void tasklet enable(struct tasklet struct *t); 


使 用 tasklet 机 制 的 三 个 步骤 是 : 
(1) 编写 tasklet 处 理 程序 : 


H 


static void tasklet callback(unsigned long data) 


1 
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printk(KERN ALERT "received a interrupt. n"); 
j 


(2) 声明 tasklet: 
DECLARE TASKLET(tasklet, tasklet callback, 0); 


(32 调度 tasklet: 


static irqreturn tirq handler(int irq, void *arg) 
{ 

tasklet_schedule(&tasklet); 

return IRQ HANDLED; 


} 


例 5.3 Tasklet 实例 
代码 见 \samples\5schedule\5-3tasklet。 核 心 代 人 码 如 下 : 


int myint for something-1; 

void tasklet function(unsigned long); 

char tasklet data[64]; 

//tasklet 初始 化 

DECLARE TASKLET(test tasklet,tasklet function, (unsigned long) &tasklet data); 
void tasklet function(unsigned long data) 


1 
struct timeval now; 
do gettimeofday(&now); 
printk("96s at old, old", (char *) data,now.tv sec,now.tv usec); 
} 
int init module task(void) 
{ 
sprintf(tasklet data,"%s\n","Linux tasklet called in init module"); 
tasklet schedule(&test tasklet); 
} 
void cleanup moduletask(void) 
{ 
return ; 
} 


module init(init module task); 
module exit(cleanup moduletask); 


本 例 运 行 结果 如 下 : 


[root@/home]#insmod tasklet.ko 
tasklet: module license 'unspecified' taints kernel. 
Linux tasklet called in init module 

at 739,210617 


任务 与 调度 
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5.5 工作 队列 


5.5.1 工作 队列 原理 
工作 队列 (work queue) 类似 tasklet， 人 允许 调用 者 请 求 在 将 来 某 个 时 间 调 用 一 个 函数 。 


tasklet 在 软件 中 断 上 下 文中 运行 ， 所 以 tasklet 执行 和 
E 最 初 被 提交 的 处 理 器 


tasklet 一 般 只 能 好 


有 更 多 的 灵活 性 ， 


们 可 以 安全 休 


system highpri wq 等 。 驱 动 程序 可 以 创建 # 
全 局 工作 队列 。 工 作 队 列 用 workqueue struct 结构 


第 2 版 


运行。 工作 队列 在 一 个 特殊 内 核 进程 上 下 文 运行 ， 


作 队 列 初始 化 接口 如 下 : 


/创建 工作 队列 ， 在 这 里 


快 ， 持 续 短 ， 并 且 一 般 在 原子 态 。 


并 且 能 够 休眠 。 工 作 队 列 包 括 一 系列 将 要 执行 的 任务 和 执行 这 些 任务 的 内 
核 线程 。 每 个 工作 队列 有 


个 专门 的 线程 ， 所 有 的 任务 必须 在 进程 的 上 下 文中 运行 ， 这 样 它 


#define create workqueue(name) 
alloc_workqueue("%s", _WQ_LEGACY | WQ MEM RECLAIM, 1, (name)) 


Ro Linux 内 核 提 供 了 一 系列 全 局 work queue, £15 system wq. 


Lu 


使 用 它 


门 自己 的 工作 队列 ， 或 者 使 用 内 核 的 一 个 


述 ， 而 任务 用 work struct 结构 描述 。 工 


#define create singlethread workqueue(name) 

alloc ordered workqueue("%s", WQ LEGACY|WQ MEM RECLAIM, name) 
/在 编译 期 初始 化 一 个 任务 
DECLARE WORK(struct work struct *work, void (*function)( struct work struct *)); 
/在 运行 期 初始 化 一 个 任务 
INIT WORK(struct work struct *work, void (*function)( struct work struct *)); 


于 创建 一 个 工作 队列 ， 它 在 系统 的 每 个 处 理 器 上 有 一 个 专用 的 线 


create workqueue 宏 用 
程 。 在 很 多 情况 下 ， 过 多 线程 对 系统 性 能 
singlethread workqueue 宏 来 创建 工作 队列 。 
可 以 用 下 面 的 函数 


周 用 把 一 个 任务 加 


入 到 了 


[ 作 队 列 中 : 


name 是 工作 队列 的 名 字 。 


A 


\ 


影响 ， 如 果 单 个 线程 就 足够 则 使 用 create_ 


bool queue work(struct workqueue struct *wq.struct work struct *work) 


int fastcall queue delayed work(struct workqueue struct *wq,struct work struct *work, unsigned long delay); 


fr queue delayed work()! 


以 后 ， 工 作 队列 ， 


取消 工作 队列 中 没有 运行 


的 任务 : 


int cancel delayed work(struct work struct *work); 


如 果 当 一 个 取消 操作 的 调 朋 
再 加 入 到 队列 中 。 


但 不 会 


/确保 调度 队列 中 的 了 
void fastcall flush workqueue(struct workqueue struct *wq); 


/销毁 工作 队列 
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[ 作 队 列 执行 完毕 ， 


这 个 函数 


在 执行 中 


指定 delay， 是 为 了 保证 至 少 在 经 过 一 段 给 定 的 最 小 延迟 时 间 
的 任务 才 可 以 真正 执行 。 


那么 这 个 任务 将 继续 执行 下 去 ， 


会 等 待 工作 队列 执行 完毕 再 返回 。 
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void destroy workqueue(struct workqueue struct *wq); 
/将 工作 置 入 全 局 工作 队列 

int fastcall schedule work(struct work struct *work); 
/延迟 一 段 时 间 后 将 任务 置 入 全 局 工作 队列 


int fastcall schedule delayed work(struct work struct *work, unsigned long delay); 


X 5-2 是 软 中 断 、tasklet 和 工作 队列 等 机 制 的 比较 。 


x 5-2 软 中 断 、tasklet 和 工作 队列 对 比 


上 较 点 软 中 断 Tasklet 工作 队列 
延 后 的 工作 ， 运 行 于 进程 
执行 上 下 文 | 。 延 后 的 工作 ， 运 行 于 中 断 上 下 文 | 延 后 的 工作 ， 运 行 于 中 断 上 下 文 | QEDUUTTO IE TIER 
E onmes 1， | 不 能 在 不 同 的 CPU 上 同时 运行 ， HO | 可 以 在 不 同 的 CPU 上 同时 
可 重 可 以 在 不 同 的 CPU 上 同时 运行 是 不 同 的 CPU 可 以 运行 不 同 的 tasklet | 运行 
Dm FRAIER KAIR TONER 
抢占 不 能 抢占 /调度 不 能 抢占 /调度 可 以 抢占 /调度 
易 用 性 不 容易 使 容易 使 容易 使 
m 如 果 延 后 的 工作 不 会 睡眠 ， 而 且 Es ES : 
更 用 场合 4 CA E pen N 延 后 的 工作 不 会 睡眠 果 延 后 的 工作 会 睡眠 
使 用 声 Paa a 如 果 延 后 的 工作 不 会 大 上 如 果 延 后 的 工作 会 睡眠 
例 5.4 工作 队列 实例 


代码 见 \samples\5schedule\5-4work。 核 心 代码 如 下 : 


static struct work struct task; 

static struct workqueue struct *my workqueue; 
static int flag = 0; 

static vold DemoTask(struct work struct *work) 


1 
printk("DemoTask run...n"); 
memset(demoBuffer,0x3 1,256); 
wake up interruptible(&simple devices-^wq); 
flag-1; 
printk("DemoTask end...\n"); 

j 

int simple init module(void) 

1 
init waitqueue head(&simple devices->wq); 
my workqueue = create workqueue(" MYQUENU?"); 
INIT WORK(&task,DemoTask); 
queue work(my workqueue, &task); 
return 0; 

fail: 
simple cleanup module(); 
return result; 

} 


本 例 运 行 结果 如 下 : 
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[root@/home]#insmod demo.ko 
DemoTask run... 

DemoTask end.… 

[root@/homel#mknod /dev/fgj c 224 0 
[root@/home]#./read 

The data is 11 


5.5.2 ”延迟 工作 队列 
延迟 工作 队列 基于 工作 队列 ， 可 以 实现 延迟 一 段 时 间 再 将 工作 加 入 到 工作 队列 : 


struct delayed work { 
struct work struct work; 
struct timer list timer;// 延 迟 时 间 
struct workqueue struct *wq; 
int cpu; 


5 


延迟 工作 队列 相关 的 函数 如 下 : 


INIT DELAYED WORK(struct delayed work*dw, void (kfunction) (struct work struct *)); 
bool queue delayed work(struct workqueue struct *wq,struct delayed work *dwork;unsigned long delay); 
bool schedule delayed work(struct delayed work *dwork,unsigned long delay); 

bool cancel delayed work(struct delayed work *dwork); 


5.6 ”内 核 时 间 


5.6.1 Linux 下 的 时 间 概念 
下 面 介绍 几 个 Linux 下 的 时 间 概 念 。 


(1) 


Jp. Linux HÆ CLOCK_TICK_RATE 来 表示 计时 器 的 输入 时 钟 脉冲 的 频率 。 


时 钟 周期 (clock cycle): 晶体 振荡 器 在 1s 内 产生 的 时 钟 脉冲 个 数 就 是 时 钟 周 基 


E 
zu 
ce 


时 钟 滴答 (clock tick): 一 次 时 钟 中 断 即 产 生 一 次 时 钟 滴答 。 系 统 每 个 时 钟 周期 产 
钟 中 断 。 
时 钟 滴答 的 频率 : 1s 内 的 时 钟 滴答 次 数 。Linux 内 核 用 宏 HZ 来 表示 时 钟 滴答 的 频 


在 不 同 的 平台 上 HZ 有 不 同 的 定义 值 ， 而 HZ 通常 表示 1s 的 时 间 。 


(2) 
生 一 次 时 
(3) 
率 ， 而 且 
(4) 
来 的 时 外 


全 局 变量 〈jiffies): 这 是 一 个 32 位 的 无 符号 整数 ， 用 来 表示 自 内 核 上 一 次 启动 以 
滴答 次 数 。 每 发 生 一 次 时 钟 滴答 ， 内 核 的 时 钟 中 断 处 理 函 数 timer interrupt 会 将 该 


全 局 变量 jiffies 加 1。 


(5) 
时 间 是 1 
(6) 
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extern unsigned long volatile jiffies; 

xtime: timeval 结构 全 局 变量 ,记载 系统 自 开 机 以 来 的 当前 时 间 ， 精 确 度 为 纳 秒 ,基准 
970 年 1 月 1 日 零点 。 
系统 时 钟 ， 也 叫 软 件 时 钟 ， 是 由 软件 根据 时 间 中 断 来 计时 的 。 系 统 时 钟 在 系统 关机 
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的 情况 下 是 不 存在 的 ， 当 操作 系统 启动 的 时 候 ， 默 认 系统 时 间 一 般 为 1970 年 1 月 1 HE 
点 。 系 统 时 间 可 以 根据 RTC 时 间 来 进行 同步 。 
在 内 核 中 可 以 使 用 下 面 的 函数 获取 或 设置 系统 时 间 : 
void do_gettimeofday(struct timeval *tv); /获取 系统 时 间 
int do _settimeofday(struct timespec *tv); /设置 系统 


Linux 中 用 来 描述 时 间 的 结构 是 timeval 和 timespec: 


struct timespec { 
time t — tv sec; // 秒 
long tv nsec; /*10 亿 分 之 一 秒 */ 


h 
struct timeval { 
time t tv. sec; // 秒 
suseconds t — tv usec; ” 访 微 秒 */ 
h 


上 面 的 结构 和 jiffies 之 间 可 以 通过 下 列 函数 互相 转换 : 


unsigned long timespec to jiffies(struct timespec *value); 

void jiffies to timespec(unsigned long jiffies, struct timespec *value); 
unsigned long timeval to jiffies(struct timeval *value); 

void jiffies to timeval(unsigned long jiffies, struct timeval *value); 


5.6. Linux 下 的 延迟 
延 后 一 段 时 间 执 行 一 个 特定 片段 的 代码 就 是 延迟 。 内 核 中 定义 了 几 个 时 间 比 较 的 宏 : 


#define time after(a,b) N 
(typecheck(unsigned long, a) && \ 
typecheck(unsigned long, b) && \ 
(Qong)((b) - (a)) < 0)) 
#define time before(a,b) time after(b,a) 
#define time after eq(a,b) V 
(typecheck(unsigned long, a) && \ 
typecheck(unsigned long, b) && \ 
(Qong)((a) - (b)) >= 0)) 
#define time before eq(a,b) time after eq(b,a) 


如 果 要 实现 长 延迟 ， 可 以 使 用 下 面 的 代码 : 
while(time_after(jiffies,j1));// 如 果 jiffies 大 于 j1， 则 一 直 循环 


毫秒 级 别 的 延迟 为 短 延迟 。 短 延迟 一 般 使 用 下 面 的 函数 实现 : 


#define ndelay(n) ”// 纳 秒 级 延迟 
#define udelay(n) — // 微 秒 级 延迟 
#define mdelay(n) /毫秒 级 延迟 
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以 上 几 种 延迟 方法 均 是 忙 等 待 形式 的 延迟 ， 会 导致 其 他 任务 此 时 无 法 使 用 CPU 资源 ， 
所 以 要 慎重 考虑 是 否 调用 这 些 函 数 实现 延迟 。 下 面 是 不 必 忙 等 的 短 延迟 方法 : 


v 


p 
- 


void msleep(unsigned int msecs) ; 
unsigned long msleep interruptible(unsigned int msecs); 


msecs 参数 的 单位 为 milliseconds。 


5.6.3 ”内 核定 时 器 

内 核 如 果 要 在 以 后 某 一 个 规定 的 时 刻 运行 一 段 程 序 或 进程 就 要 用 到 内 核定 时 器 。 内 核定 
时 器 是 一 种 软件 定时 器 ， 它 可 以 在 一 个 确切 的 时 间 点 上 激活 相应 的 程序 段 或 进程 。Linux 内 
核 中 定义 了 一 个 timer_ list 结构， 利用 它 可 以 实现 内 核定 时 器 功能 : 


struct timer list { 
struct list head list; 
unsigned long expires; /定时 器 到 期 时 间 
unsigned long data; // 作 为 参数 被 传 入 定时 器 处 理 函 数 
void (*function)(unsigned long); /回调 处 理 函 数 
h 
与 定时 器 相关 的 函数 包括 : 
// 增 加 定时 器 
void add timer(struct timer list * timer); 
/删除 未 到 期 的 定时 器 。 到 期 的 定时 器 会 自动 删除 
int del timer(struct timer list * timer); 
// 修 改定 时 器 的 expire 值 
int mod timer(struct timer list *timer, unsigned long expires); 
例 5.5 内 核定 时 器 实例 
本 例 演示 内 核定 时 器 的 基本 用 法 ， 安 装 模 块 会 启动 定时 器 ， 务 载 模块 会 停止 定时 器 。 代 
人 码 见 \samples\5schedule\5-5time。 核 心 代码 如 下 : 


#define SIMPLE TIMER DELAY 2*HZ//2Second 
struct simple dev *simple devices; 
static unsigned char simple inc=0; 
struct timeval start,stop,diff; 
static struct timer list simple timer; 
static vold simple timer handler(unsigned long data); 
/计算 时 间 差 
int timeval subtract(struct timeval* result, struct timeval* x, struct timeval* y) 
1 
If(x-^tv sec2y-^tv sec) 
return -1; 
if((x-^tv sec——y-^tv sec)&&(x-^tv usec-y-^tv usec)) 
return -1; 
result-^tv sec = ( y-^tv sec-x-^tv sec); 
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j 


A 


55* 


result-^tv usec = ( y-^tv usec-x-^tv usec ); 
if(result-^tv usec«0) 
{ 
result->tv_sec--; 
result->tv_usec+=1000000; 
} 


return 0; 


/定时 器 处 理 函 数 


static vold simple timer handler( unsigned long data) 


1 


j 


do gettimeofday(&stop); 

timeval subtract(&diff,&start,&stop); 

printk("9od S %d MS elapsed" ,diff.tv sec,difftv usec); 
mod timer(&simple timer, jiffies + HZ); 


return ; 


void simple cleanup module(void) 


1 


j 


del timer(&simple timer); 


int simple init module(void) 


1 


int result; 

/初始 化 定时 器 

init timer(&simple timer); 

simple timer.function — &simple timer handler; 

simple timer.expires — jiffies - SIMPLE TIMER DELAY; 
add timer (&simple timer); 

do gettimeofday(&start); 

return 0; /*succeed*/ 


[root(Q)urbetter drivers | insmod timedemo.ko 
[root(a)urbetter drivers |Z 1 S 994727 MS elapsed 
2 S 994726 MS elapsed 

3 S 994725 MS elapsed 

4 S 994726 MS elapsed 

5 S 994727 MS elapsed 

6 S 994725 MS elapsed 

7 S 994726 MS elapsed 

8 S 994726 MS elapsed 

9 S 9947277 MS elapsed 

10 S 994729 MS elapsed 

11 S 994726 MS elapsed 


E. 


任务 与 调度 
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[root(Q)urbetter drivers |£ rmmod timedemo 
[root@urbetter drivers]? 


另外 ，timer list->function 有 一 个 参数 ， 这 个 参数 存放 在 timer. list->Data H 


simple timer. Data-5; 
simple timer.function — &simple timer handler; 


add timer (&simple timer); 


修改 之 后 simple timer handler 函数 的 参数 data 的 值 应 为 5。 
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P， 使 用 方法 如 下 : 


A^ 


p 


MILESE 


动 程 序 开发 。 硬 件 设 备 驱动 程序 不 外 乎 时 序 控制 、 
S3C6410X 处 理 器 为 例 介 绍 最 简单 的 硬件 设备 驱动 程序 开发 方法 。 


mu 


6 5i 


简单 硬件 设备 驱动 程序 


1f Linux 下 编写 设备 驱动 程序 的 最 基本 


的 知识 点 ， 接 下 来 接触 实际 的 硬件 驱 


d= 


6.1 硬件 基础 知识 


6.1.1 硬件 设备 原理 


mou 


通常 
之 间 通 过 接口 


Ll. PCI, MDIO, 


-Ed3, H 


Tal I) CR e 
挂 载 多 个 外 围 


不 一 由 
芯片 ， 处 理 
为 了 提升 代码 的 灵 


个 Linux 运行 的 硬件 平台 包括 一 个 处 理 


Vs 


寄 


存 器 访问 与 中 断 处理 。 本 草 以 三 星 


器 以 及 各 种 外 围 


Do Aar hE 


连接 。 总 线 是 传输 


通道 


ra 
IE] 


I2S ^" 


等 
EM). MR 
器 对 这 
活性 与 扩 


车。 处 理 器 为 各 种 接 
芯片 通过 标准 接口 


。 接 口 是 连 接 规 范 。 常 用 的 接口 包括 DC. 


SPI、 并 行 接 


提供 了 控制 器 ， 当 然 每 种 处 理 器 提供 的 


展 性 ，Linux 的 


则 
HE P OMIVA EI 


的 接 


, 


Ka, 


为 很 多 子 系统 ， 这 些 子 系统 有 的 是 旬 
能 的 ， 例 如 RTC 驱动 、Framebuffer 驱动 。 表 6-1 是 Linux 9 


将 处 理 器 的 接 


di Up oJ 


控制 


与 外 围 


心 片 驱 动 进 


协议 与 处 理 器 通 
片 进行 分 时 控制 。 
内 


信 。 同 一 个 总 线 上 也 可 能 


核 驱 动 


AT 


尺码 的 架构 也 遵循 了 功能 分 离 原 
。 这 样 更 换 处 理 器 只 需要 更 换 处 


Vds FUSE 


4 


J; 
控制 器 驱动 不 动 ， 这 给 驱动 j 


行 
更 换 外 围 芯片 ， 只 需要 更 
FRA RER Y B e UR 
对 接口 的 ， 例 如 I2C 驱动 、U 


JJ 


换 外 围 芯片 对 应 的 驱动 ， 处 理 器 
|。 另 外 ，Linux 驱动 层 可 以 划分 
SB 了 驱动， 也 有 的 是 针对 功 


K 动 层 的 子 系统 列表 。 


表 6-1 Linux 驱动 层 的 子 系统 


类 别 驱动 子 系统 说 明 
Dc 
SPI 
接口 通信 类 USB 
PCI 
SCSI 支持 硬盘 、 光 了 驱 等 
Watchdog 看 门 狗 
RTC 实时 时 钟 驱动 
Framebuffer 贰 缓存 驱动 ， 用 于 支持 显示 设备 
功能 类 TTY TTY 设备 驱动 ， 包 括 串 口 驱动 
MTD 于 支持 Flash 等 存储 设备 
V4L2 视频 类 设备 驱动 
网 络 设备 驱动 包括 MAC 层 驱 动 、PHY 驱动 、CAN 驱动 等 
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CÈ) 
Sound 音频 驱动 ， 主 要 是 ALSA 架构 
Backlight 屏幕 背光 控制 Cdrivers/video/backlight) 
功能 类 inpit 输入 子 系统 ， 用 于 支持 鼠标 、 键 竹 、 触 摸 屏 、 红 外 遥控 等 设备 
m 工业 VO 子 系统 ， 于 支持 ADC、 加 速度 传感器 、 陀 螺 仪 、IMU( 惯 性 测量 单 
| Lf. cpc( 电 容 数 字 转 换 鄙 、 压 力 、 温度 和 光线 传 感 由 


处 理 器 访问 硬件 设备 主要 通过 以 下 几 种 方式 : 
(1) 内 存 方式 。 外 设 的 内 存 空 间 被 映射 到 处 理 器 的 地 址 空间 ， 处 理 器 通过 访问 映射 地 


址 来 访问 硬件 。 


(2) LO 接口 。 处 理 器 与 IO 设备 之 间 通 过 一 定 


IO 接口 中 包括 一 


在 x86 体系 


上 县， 并 设置 参数 。 
(3) 管 脚 (Pin)。 管 脚 可 以 用 来 对 芯片 进行 复位 ， 并 接收 来 自 设备 的 中 断 信 号 。 另 外 


E 的 接口 连接 ， 这 个 接口 就 是 VO 接口 。 


组 寄存 器 (Register) 以 及 控制 电路 。 这 些 寄存 器 可 用 来 获取 设备 的 状态 信 


有 些 蕊 片 还 可 以 通过 管 脚 进 行 简单 的 模式 配置 。 


du dd i UE 
IO mH. Æ ARM 等 体系 中 ，1/O 通常 是 和 内 存 统 


问 速度 最 快 的 内 存 。 
6.1.2 ”时 序 图 原理 


时 序 图 描述 的 是 总 线 上 的 电 平 与 时 间 的 关系 ， 
数据 。 假 如 总 线 上 包含 两 根 信号 线 CS 5 DAT, "1C 


效 ， 这 个 约定 可 以 用 图 6-1 所 示 的 时 序 图 表示 。 
| 1ous E—— 10045] 


AE NE NM 


图 6-1 简单 时 序 


利用 这 个 时 序 图 发 送 数据 的 C 语言 伪 代 码 如 下 : 


void senddata(unsigned bdata) 


1 


(ESS 


0; 


DAT= bdata; 
udelay(10); 


CS= 


1; 


udelay(100); 
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总 线 上 的 设备 总 是 按照 规定 的 时 序 来 收发 
CS 线 为 高 电 平 时 DAT 线 上 发 送 的 数据 有 
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CS=0; 
} 


6.1.[3 PELA X Linux 系统 构成 


ARARA Linux. 系统 按 存 储 空 间 划分 通常 包括 引导 区 、 内 核 区 与 文件 系统 区 ， 
引导 区 存放 BootLoader 与 系统 参数 ， 内 核 区 存放 特定 嵌入 式 平台 的 定制 Linux 内 核 ， 文 件 系 
统 区 包括 根 文件 系统 和 建立 于 Flash 内 存 设 备 之 上 的 文件 系统 。 图 形 界面 系统 和 用 户 应 用 程 
序 就 放 在 文件 系统 中 。 图 6-2 就 是 一 个 同时 装 有 BootLoader、 系 统 启动 参数 、 内 核 映 像 和 村 
文件 系统 映像 的 固态 存储 设备 的 典型 空间 分 配 结构 图 。 


其 他 部 分 
根 文件 系统 


图 6-2 WAI Linux 系统 的 典型 存储 结构 


1MB-5MB 


100KB-1MB 


BootLoader 占用 的 空间 一 般 比 较 小 ， 它 后 面 紧 接着 一 个 启动 参数 区 ， 用 来 保存 Linux 内 
核 启 动 参数 和 用 户 启 动 设置 。Bootloader 程序 是 欢 入 式 系统 的 引导 加 载 程序 ， 是 系统 加 电 后 
运行 的 第 一 段 软件 代码 。Bootloader 程序 是 硬件 相关 的 。 在 基于 ARM WRARRAF, A 
统 在 上 电 或 复位 时 通常 从 地 址 0x00000000 处 开始 执行 ，Bootloader 程序 一 般 就 安装 在 这 个 
地 址 。Bootloader 程序 的 主要 任务 是 初始 化 硬件 设备 、 建 立 内 存 空间 的 映射 图 ， 从 而 将 系统 
的 软 人 硬件 环境 带 到 一 个 合适 的 状态 。Bootloader 程序 最 重要 的 任务 就 是 启动 Linux 内 核 。 

Linux 内 核 一 般 占 用 1~5MB 空间 。Linux 内 核 的 启动 部 分 与 驱动 部 分 也 是 硬件 相关 
的 ， 需 要 针对 特定 硬件 进行 移植 。 

文件 系统 是 嵌入 式 Linux. 系统 中 占用 空间 最 大 的 部 分 ， 它 通常 占据 了 BootLoader 和 内 
核 之 外 的 所 有 空间 。Linux 启动 完毕 会 加 载 一 个 根 文 件 系 统 ， 根 文件 系统 包含 了 系统 的 必 备 
的 配置 信息 、 函 数 库 和 shell 解释 器 、 核 心目 录 等 。 其 他 的 文件 系统 可 以 挂 载 在 根 文件 系统 
下 面 。 

BootLoader 一 般 通 过 JTAG 接口 和 仿真 器 烧 写 到 存储 器 ， 而 内 核 和 文件 系统 则 可 以 通过 
串口 和 网 口 烧 写 到 存储 器 。 


61.4 ”硬件 初始 化 
内 核 启动 时 ， 各 种 硬件 资源 要 进行 初始 化 。 每 种 硬件 体系 的 初始 化 代码 不 一 样 ， 内 核 采 
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] MACHINE START 宏 来 设置 各 种 体系 的 初始 化 代码 。 例 如 对 SMDK6410 的 初始 化 设置 
/arch/arm/mach-s3c6410/mach-smdk6410.c "P: 


MACHINE START(SMDK6410, "SMDK6410") 
/*Maintainer: Ben Dooks <ben-linux@fluff.org>*/ 
.atag offset = Ox100, 


nr irqs = $3C64XX NR IRQS, 
nit irq = $3c6410 init irq, 

.map io = smdk6410 map io, 

nit machine- smdk6410 machine init, 
init time = samsung timer init, 
restart = s3c64xx restart, 


MACHINE END 


s3c6410 init irq 用 来 初始 化 中 断 ， 它 调用 了 s3c64xx init irq 函数 : 


void  inits3c6410 init irq(void) 


1 
/*VICO is missing IRQ7, VICI is fully populated.*/ 
s3c64xx init irq(—0 & 一 (1 «« 7), —0); 
} 
/中 断 初 始 化 
void _ init s3c64xx init irq(u32 vicO valid, u32 vicl valid) 
1 
/初始 化 时 钟 与 看 门 狗 
S3c64xx clk init(NULL, xtal f, xusbxti f, soc is s3c6400(), S3C VA SYS); 
samsung wdt reset init(S3C VA WATCHDOG); 
printk(KERN DEBUG "95s: initialising interruptsn", func ); 
Pg ap erp rs] fet 
vic init(VA VICO, IRQ VICO BASE, vic0 valid, IRO VICO RESUME); 
vic init(VA VICI,IRQ VICI BASE, vicl valid, IRQ VICI RESUME); 
} 


smdk6410_map_io 函数 用 来 映射 IO， 初始 化 一 些 外 围 设备 : 


static void _ init smdk6410 map io(void) 

1 
u32 tmp; 
s3c64xx init io(smdk6410 iodesc, ARRAY SIZE(smdk6410 iodesc)); 
S3c64xx set xtal freq(12000000); 
s3c24xx init uarts(smdk6410 uartcfgs, ARRAY SIZE(smdk6410 uartcfgs)); 
samsung set timer sourc(SAMSUNG PWM3, SAMSUNG PWM4); 
[** E LCD 类 型 和 
tmp- raw readl(S3C64XX SPCON); 
tmp &= -—S3C64XX SPCON LCD SEL MASK; 
tmp |= S53C64XX SPCON LCD SEL RGB; 
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. Taw_writel(tmp, S3C64XX SPCON); 

PER LCD 旁 路 */ 

tmp- raw readl(S3C64XX MODEM MIFPCON); 

tmp &- —MIFPCON LCD BYPASS; 

. raw writel(tmp, S3C64XX MODEM MIFPCON); 
} 


smdk6410 machine init 函数 用 来 初始 化 硬件 设备 : 


static void — init smdk6410 machine init(void) 
1 
u32 csl; 
/初始 化 DC 
S3c i2c0 set platdata(NULL); 
s3c i2cl set platdata(NULL); 
S3c fb set platdata(&smdk6410 lcd pdata); 
dwc2 hsotg set platdata(&smdk6410 hsotg pdata); 
samsung keypad set platdata(&smdk6410 keypad data); 
S3c64xx ts set platdata(NULL); 
/*WL E. nCS1 为 16bit 线 宽 */ 
cs] — raw readl(S3C64XX SROM BW) & 
~(S3C64XX SROM BW CS MASK << S3C64AXX SROM BW NCSI SHIFT); 
csl|-((1«« S3C64XX SROM BW DATAWIDTH  SHIFT)| 
(1 << S3C64XX SROM BW WAITENABLE SHIFT)| 
(1 << S3C64XX SROM BW BYTEENABLE SHIFT)) << 
S3C64XX SROM BW NCSI SHIFT; 

. raw writel(csl, S3C64XX SROM BW); 
EEA MARS TI nCST 时 序 */ 
. raw writel((0 << S3C64XX SROM BCX PMC SHIFT)| 

(6 << S3C64AXX SROM BCX TACP SHIFT)| 

(4 << S3C64XX SROM BCX TCAH SHIFT)| 

(1 << S3C64AXX SROM BCX TCOH SHIFT)| 

(0xe << S3C64AXX SROM BCX TACC SHIFT)| 

(4 << S3C64XX SROM BCX TCOS SHIFT)| 

(0 << S3C64XX SROM BCX TACS SHIFT), S3C64XX_SROM_BC1); 
/为 LCD 电源 控制 申请 GPIO 
gpio request(S3C64XX GPN(5), "LCD power"); 
gpio request(S3C64XX GPF(13), "LCD power"); 
/注册 IC 板 级 设备 
12c register board info(0, i2c_ devs0,ARRAY SIZE(i2c devs0)); 
12c register board info(l,12c devsl, ARRAY SIZE(i2c devsl)); 
S3c ide set platdata(&smdk6410 ide pdata); 
/注册 平台 设备 
platform add devices(smdk6410 devices, ARRAY SIZE(smdk6410 devices)); 
pwm add table(smdk6410 pwm lookup, ARRAY SIZE(smdk6410 pwm lookup)); 
samsung bl set(&smdk6410 bl gpio info, &smdk6410 bl data); 
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smdk6410 devices 中 定义 了 需要 注册 的 设备 列表 : 


static struct platform device *smdk6410 devices[]  initdata = { 
#ifdef CONFIG SMDK6410 SD CHO 
&s3c device hsmmc0, 
#endif 
#ifdef CONFIG SMDK6410 SD CHI 
&s3c device hsmmcl, 
#endif 
&s3c device i2c0, 
&s3c device i2cl, 
&s3c device fb, 
&s3c device ohci, 
&samsung device pwm, 
&s3c device usb hsotg, 
&s3c64xx device iisv4, 
&samsung device keypad, 
#ifdef CONFIG REGULATOR 
&smdk6410 b pwr 5v, 
#endif 
&smdk6410 lcd powerdev, 
&smdk6410 smsc911x, 
&s3c device adc, 
&s3c device cfcon, 
&s3c device rtc, 
&s3c device wdt, 


35 
6.1.55 clk 体系 


时 钟 就 像 人 的 心跳 ， 没 有 时 钟 ， 外 设 就 无 法 运行 。 时 钟 相 关 的 内 核 代 码 在 /drivers/clk H 
Xo devm clk get 函数 用 来 获取 外 设 时 钟 : 


T 


struct clk *devm clk get(struct device *dev, const char *id); 
使 能 /禁止 时 钟 的 函数 如 下 : 


int clk prepare enable(struct clk *clk); 
void clk disable unprepare(struct clk *clk); 


时 钟 必须 初始 化 才能 获取 。s3c64xx init irq 函数 调用 了 s3c64xx clk init 来 初始 化 时 钟 : 


s3c64xx clk init(NULL, xtal f, xusbxti f, soc is s3c6400(), SAC VA SYS); 


s3c64xx clk init 代码 在 /drivers/clk/samsung/clk-s3c64xx.c "P: 


void init s3c64xx clk init(struct device node *np, unsigned long xtal f, 
unsigned long xusbxti f, bool s3c6400,void  jomem *base) 


120 


j 


第 6 章 简单 硬件 设备 驱动 程序 


struct samsung clk provider *ctx; 
reg base = base; 
is S3c6400 = s3c6400; 
if (np) 1 

reg base = of 1omap(np, 0); 

if (Ireg base) 

panic("%s: failed to map registers", func ); 

j 
ctx= samsung clk init(np, reg base, NR. CLKS); 
if (!ctx) 

panic("%s: unable to allocate context", — func ); 
MERSE 
if (!np) 
s3c64xx clk register fixed ext(ctx, xtal f, xusbxti f); 
MEH PLL*/ 
samsung clk register pll(ctx, s3c64xx pll clks,ARRAY SIZE(s3c64xx pll clks), reg base); 
MEARE V EST pen 
samsung clk register fixed rate(ctx, s3c64xx fixed rate clks, ARRAY SIZE(s3c64xx fixed rate clks)); 
samsung clk register mux(ctx, s3c64xx mux clks, ARRAY SIZE(s3c64xx mux clks)); 
samsung clk register div(ctx, s3c64xx div clks, ARRAY SIZE(s3c64xx div clks)); 
samsung clk register gate(ctx, s3c64xx gate clks,ARRAY SIZE(s3c64xx gate clks)); 
MEW SOC 相关 的 时 钟 */ 
samsung clk register mux(ctx, s3c6410 mux clks,ARRAY SIZE(s3c6410 mux clks)); 
samsung clk register div(ctx, s3c6410 div clks,ARRAY SIZE(s3c6410 div clks)); 
samsung clk register gate(ctx, s3c6410 gate clks,ARRAY SIZE(s3c6410 gate clks)); 
samsung clk register alias(ctx, 33c6410 clock aliases, ARRAY SIZE(s3c6410 clock aliases)); 
samsung clk register alias(ctx, s3c64xx clock aliases, ARRAY SIZE(s3c64xx clock aliases)); 
S3c64xx clk sleep init(); 


samsung clk of add provider(np, ctx); 
pr_info("%s clocks: apll = %lu, mpll = %lu\n" 
"Ntepll = %lu, arm. clk = %lu\n", 
is s3c6400 ? "S3C6400" : "S3C6410", 
get rate("fout apll"), get rate("fout mpll"), 


get rate("fout epll"), get rate("armclk")); 


S3C6410X 外 围 设 备 需 要 的 时 钟 均 在 此 注册 。 


6.2 dev/mem 5 dev/kmem 


/dev 目录 下 有 两 个 特殊 的 节点 : /dev/mem 与 /dev/kmem。/dev/mem 是 物理 内 存 的 映射 ， 
可 以 用 来 访问 物理 IO 设备 ， 例 如 接口 控制 器 的 寄存 器 。/dewkmem 是 虚拟 内 存 的 映射 ， 可 
以 用 来 查看 kerel 的 变量 等 信息 。 


例 


6.1 devmem2 实例 


代码 见 \samples\6hardsimple\6-1devmem\devmem2。 核 心 代码 如 下 : 
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int main(int argc, char **argv) { 
int fd; 
void *map base, *virt addr; 
unsigned long read result, writeval; 
off t target; 
int access type —'w'; 
if(argc < 2) { 
fprintf(stderr, ^nUsage:X9os ( address ) [ type [ data ] |n" 
"Ntaddress : memory address to act upon" 
"Nttype : access operation type : [b]yte, [h]alfword, [w]ord\n" 


"Atdata : data to be written nn", 
argv[0]); 
exit(1); 
j 
target — strtoul(argv[1], 0, 0); 
if(argc > 2) 


access type = tolower(argv[2 ][0]); 
/打开 内 存 设备 
if((fd = open("/dev/mem", O RDWR | O SYNO)) == -1) FATAL; 
printf("/dev/mem opened. n"); 
fflush(stdout); 
PRORA RCTBES/ 
map base = mmap(0, MAP SIZE, PROT READ | PROT WRITE, MAP SHARED, fd, target 
& —MAP MASK); 
if(map base == (void *) -1) FATAL; 
printf("Memory mapped at address op. n", map. base); 
fflush(stdout); 
/根据 数据 类 型 获取 内 存 的 值 
virt addr = map base + (target & MAP MASK); 
switch(access type) { 
case 'b': 


read result = *((unsigned char *) virt addr); 
break; 
case 'h': 
read result — *((unsigned short *) virt addr); 
break; 
case 'w': 
read result — *((unsigned long *) virt addr); 
break; 
default: 
fprintf(stderr, "Illegal data type '%c'.\n", access type); 
exit(2); 
} 
printf(" Value at address 0x%X (%p): Ox%X\n", target, virt addr, read result); 
fflush(stdout); 
if(argc > 3) ( 
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writeval = strtoul(argv[3], 0, 0); 
switch(access type) { 


case 'b': 
*((unsigned char *) virt addr) — writeval; 
read result — *((unsigned char *) virt addr); 
break; 
case 'h': 
*((unsigned short *) virt addr) = writeval; 
read result — *((unsigned short *) virt addr); 
break; 
case 'w': 
*((unsigned long *) virt addr) = writeval; 
read result = *((unsigned long *) virt addr); 
break; 
} 
printf(" Written Ox%X; readback 0x%X\n", writeval, read result); 
fflush(stdout); 
} 
/取消 映射 
ifímunmap(map base, MAP SIZE) == -1) FATAL; 
close(fd); 
return 0; 


} 
下 面 的 实例 使 用 devmem2 控制 RTC 相关 的 寄存 器 。 


[root@urbetter drivers]# ./devmem2 — 0x70000000 
/dev/mem opened. 

Memory mapped at address 0xb6f64000. 

Value at address 0x70000000 (0xb6f64000): OxDO 


RTCCON 寄存 器 地 址 =0x7E005040 
[root@urbetter drivers]£ ./devmem2 0x7E005040 
/dev/mem opened. 

Memory mapped at address Oxb6f6f000. 

Value at address 0x7E005040 (Oxb6f6f040): 0x1 


BCDSEC 寄存 器 地 址 =0x7E005070， 秒 寄存 器 
从 下 面 的 结果 可 以 看 出 秒 寄存 器 的 变化 ， 由 于 秒 在 走 ， 所 以 date 命令 与 寄存 器 的 值 有 一 定 的 差异 。 
[root@urbetter drivers |? date 

Mon May 31 03:27:22 CST 2004 

[root(Q)urbetter drivers | ./devmem2 — 0x7E005070 
/dev/mem opened. 

Memory mapped at address 0xb6f73000. 

Value at address 0x7E005070 (0xb6f73070): 0x25 
[root(gjurbetter drivers]? date 

Mon May 31 03:27:27 CST 2004 

[root(Q)urbetter drivers]£ ./devmem2 — 0x7E005070 
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/dev/mem opened. 

Memory mapped at address Oxb6f88000. 

Value at address 0x7E005070 (0xb6f88070): 0x29 
[root(a)urbetter drivers | 


BCDMIN 寄存 器 地 址 =0x7E005074， 分 钟 寄 存 器 
[root@urbetter drivers]? date 

Mon May 31 03:29:15 CST 2004 

[root(Q)urbetter drivers|7 ./devmem2 — 0x7E005074 
/dev/mem opened. 

Memory mapped at address 0xb6f74000. 

Value at address 0x7E005074 (0xb6f74074): 0x29 


下 面 的 实例 使 用 devmem2 写 GPIO 寄存 器 ， 并 控制 LED 4T. LED 灯 接 在 S3C6410X 的 
GM0—GM3 E, fs LED 灯 只 需要 控制 GPMCON(0x7F008820) Ej GPMDAT(0x7F008824) 
两 个 寄存 器 即 可 。 


2: 


[root@urbetter home]# ./devmem2 0x7F008820 w 0x111111 
/dev/mem opened. 

Memory mapped at address Oxb6fef000. 

Value at address 0x7F008820 (0xb6fef820): 0x0 

Written Ox111111; readback 0x111111 

点 亮 LED 

[root@urbetter home]  ./devmem2 0x7F008824 w 0x0000001F 
/dev/mem opened. 

Memory mapped at address Oxb6fd0000. 

Value at address 0x7F008824 (0xb6fd0824): 0x0 

Written Ox1F; readback Ox1F 

KEK LED 

[root@urbetter home]?  ./devmem2 . 0x7F008824 w 0x00000000 
/dev/mem opened. 

Memory mapped at address Oxb6fdb000. 

Value at address 0x7F008824 (0xb6fdb824): Ox1F 

Written 0x0; readback 0x0 

[root(a)urbetter home] 


63 ” 寡 存 器 访问 


6.3.1 S3C6410X 地 址 映射 


本 


于 S3C6410X 有 部 分 架构 继承 于 


实例 都 是 基于 三 星 的 S3C6410X 处 理 器 。 


S3C24XX 系列 ， 所 以 部 分 代码 也 能 看 到 S3C24XX 的 影子 。S3C6410X 支持 32 位 物理 地 址 


空间 ， 这 些 地 址 空间 分 成 两 部 分 ， 一 部 分 用 于 存储 ， 男 一 部 分 用 于 外 设 。 


S3C6410X 处 理 器 通过 SPINE 总 线 访问 主 存 区 ， 主 存 区 的 地 址 范围 是 0x0000 0000— 
0x6FFF_FFFF， 分 为 四 个 区 域 ， 见 表 6-2。 
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表 6-2. S3C6410X 处 理 器 的 地 址 映射 


d 


分 区 地 址 范围 


说 明 


引导 镜像 区 | 0x0000 0000—0x07FF FFFF 


的 启动 镜像 


没有 真实 映射 的 内 存 ， 但 包含 一 个 指向 内 部 存储 区 或 静态 存储 区 的 一 部 分 


内 部 存储 区 | 0x0800_0000 一 0x0FFF_FFFF 


H 


0x0800_0000 ~ 0x0BFF_FFFF, 
OxOFFF FFFF 


-启动 代码 访问 内 部 ROM 和 内 部 SRAM。 内 部 ROM 的 地 址 范围 是 


内 部 SRAM 的 地 址 范围 是 0x0C00 0000 一 


静态 存储 区 |  Ox1000 0000—0x3FFF FFFF 


来 访问 SROM, SRAM, NOR Flash、 同 步 NOR 接口 设备 和 Steppingstone。 


有 6 个 bank， 每 个 bank 有 128MB， 每 一 块 区 域 代 表 一 个 芯片 选择 


动态 存储 区 |  0x4000 0000—0x6FFF FFFF 


外 设 区 域 通过 PERI 总 线 被 访 


址 范围 的 所 有 的 特殊 功能 寄存 器 CSERO 都 能 被 访问 。S3C6410X 处 理 器 的 主要 外 设 如 


所 示 。 


System Peripheral 
RTC 


TFT LCD 
Controller 


Resolution typically 
800X 480 
Color- TFT LCD 


图 6- 


0x4000 0000—0x4FFF FFFF 


为 保留 地 址 ，0x5000_0000 一 0x6FFF_FFFF fH 


DRAM 内 存 控制 器 1(DDMC1) 使 


问 ， 它 的 地 址 范围 是 0x7000 0000—0x7FFF FFFF。 这 个 地 


ARM Core 
ARM1176JZF-S 
I/D-Cache 16KB 


I/D-TCM 16KB 
533/667MHz 


X64/32 Multi-Layer AHB/AXI Bus 


而 


6-3 


Connectivity 
128/128 5-ch 


12C X2 
UART X4 
GPIO 
IrDA v1.1 
SPI(Full Duplex) 
HIS(Modem I/F) 
USB OTG 2.0 
USB Host 1.1 
HS-MMC/SD 
AC97/PCM Audio I/F 


3 S3C6410X 处 理 器 的 主要 外 设 


S3C6410X 的 外 设 地 址 在 /arch/arm/mach-s3c64xx/include/mach/map.h 中 定义 。 


//MMC 地 址 


#define S3C64XX PA HSMMC(x) 
#define S3C64AXX PA HSMMCO 
#define S3C64XX PA HSMMCI 
#define S3C64XX PA HSMMC2 


/串口 地 址 

#define S3C_PA_UART 
#define S3C PA UARTO 
#define S3C PA UARTI 
#define S3C PA UART2 
#define S3C PA UART3 
#define SAC UART OFFSET 
#define SAC VA UARTO 


(0x7F005000) 


(0x7C200000 + (x) * 0x100000)) 
S3C64XX PA HSMMC(0) 
S3C64XX PA HSMMC(1) 
S3C64XX PA HSMMC(2) 


(S3C PA UART - 0x00) 

(S3C PA UART + 0x400) 
(S3C PA UART - 0x800) 
(S3C PA UART + 0xC00) 


(0x400) 


S3C VA UARTx(0) 
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#define S3C_VA UARTI 

#define S3C_VA UART2 

#define S3C VA UART3 
/外 设 物理 地 址 

#define S3C64XX PA NAND 
#define S3C64XX PA FB 

?tdefine S3C64XX PA USB HSOTG 
#define S3C64XX PA WATCHDOG 
define S3C64XX PA SYSCON 
define S3C64XX PA AC97 

#define S3C64XX PA IISO 

#define S3C64XX PA IISI 

#define S3C64XX PA TIMER 
#define S3C64XX PA IICO 

#define S3C64XX PA PCMO 
#define S3C64XX PA PCMI 
#define S3C64XX PA IISV4 
#define S3C64XX PA IICI 

//GPIO 地 址 

#define S3C64XX PA GPIO 

#define S3C64XX VA GPIO 
#define S3C64XX SZ GPIO 
//SDRAM 地 址 
#define S3C64XX PA SDRAM 

/中 断 向 量 控制 器 物理 地 址 

#define S3C64XX PA VICO 

#define S3C64XX PA VICI 

// MODEM 地 址 

#define S3C64XX PA MODEM 
#define S3C64XX VA MODEM 
/USB 地 址 

define S3C64XX PA USBHOST 
#define S3C64XX PA USB HSPHY 
#define S3C64XX VA USB HSPHY 
/中 断 向 量 控制 器 虚拟 地 址 

#define S3C_VA_VIC0 

#define S3C VA VICI 


在 Linux PUAA hE 


EE AEA REW IR]. HIER] A 3X n] ECC 


S3C VA UARTx(1) 
S3C VA UARTx(2) 
S3C VA UARTx(3) 


(0x70200000) 
(0x77100000) 
(0x7C000000) 
(0x7E004000) 
(0x7EO0F000) 
(0x7F001000) 
(0x 7F002000) 
(0x7F003000) 
(0x7F006000) 
(0x 7F004000) 
(0x 7F009000) 
(0x7F00A000) 
(0x 7F00D000) 
(0x 7F00F000) 


(0x7F008000) 
S3C ADDR CPU(0x00000000) 
SZ 4K 


(0x50000000) 


(0x71200000) 
(0x71300000) 


(0x74108000) 
S3C ADDR CPU(0x00100000) 


(0x74300000) 
(0x7C100000) 
S3C ADDR CPU(0x00200000) 


(S3C VA IRQ + 0x00) 
(S3C VA IRQ + 0x10000) 


[uua 


定 地 址 映射 方式 ， 下 面 是 几 个 固定 地 址 映射 的 宏 ; 


#define S3C ADDR BASE 
#define S3C_ ADDR(x) 
#define SAC ADDR. CPU(x) 


下 面 是 一 些 S3C6410X 内 部 控制 器 的 地 址 映射 定义 : 


(0xF4000000) 
(S3C ADDR BASE + (x)) 
S3C ADDR(0x00500000 + (x) 
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日 
#define S3C_VA IRQ S3C ADDR(0x00000000) P*irq 控制 器 */ 
#define SAC VA _ SYS S3C ADDR(0x00100000) PEERS lan 
"define S3C VA MEM  S3C ADDR(0x00200000) /* Wes BAS 
#define S3C VA TIMER S3C ADDR(0x00300000) P* I] Bp ER TE] 
define S3C VA WATCHDOG  S3C ADDR(0x00400000)  / Æ J%*/ 
define S3C VA UART S3C ADDR(0x01000000) PFERETS/ 


另 一 种 地 址 映射 方式 就 是 采用 ioremap 函数 ， 有 具体 见 第 4 章 。 

当 VO 寄存 器 与 内 存 统一 编 址 时 ，1/O 寄存 器 也 称 为 VO 内 存 。 当 IO 寄存 器 与 内 存 分 开 
编 址 时 ，LIO 寄存 器 也 称 为 IO 端口 。S3C6410X 采用 VO 内 存 方式 。 在 VO 内 存 资 源 的 物理 
地 址 映射 成 核心 虚拟 地 址 后 ， 理 论 上 讲 就 可 以 像 读 写 RAM 那样 直接 读 写 IO 内 存 资源 了 。 
为 了 保证 驱动 程序 的 跨 平 台 的 可 移植 性 ， 应 该 使 用 Linux 中 特定 的 函数 来 访问 IO 内 存 资 
源 ， 而 不 应 该 通过 指向 核心 虚拟 地 址 的 指针 来 访问 。 例 如 在 ARM 平台 上 ， 读 写 VO WK 
数 ， 参 见 /archyarnyinclude/asmyio.h 以 及 /include/asm-generic/io.h。 

原始 的 VO 内 存 读 写 函数 如 下 ; 


H 


TE 


-— 


void raw writew(ul6 val, volatile void  jiomem *addr); 
ul6 raw readw(const volatile void  jiomem *addr); 
void raw writeb(u8 val, volatile void  jiomem *addr); 
u8 raw readb(const volatile void _ jomem *addr); 

void raw writel(u32 val, volatile void — jiomem *addr); 
u32 raw readl(const volatile void  iomem *addr); 


下 面 的 UO 内 存 函数 在 _Traw_readl 55 — raw write 函数 基础 上 增加 了 内 存 屏 障 处 理 
确保 读 写 的 安全 性 。 


以 


void writew(u16 val, volatile void _ jiomem *addr); 

ul6 readw(const volatile void | iomem *addr); 

void writeb(u8 val, volatile void _ iomem *addr); 

u8 readb(const volatile void _ jomem *addr); 

void writel(u32 val, volatile void _ 1omem *addr); 

u32 readl(const volatile void | iomem *addr); 

u8 ioread8(u8 value, volatile void — jomem *addr); 
ul6 ioread16(u16 value, volatile void _ iomem *addr); 
u32 1oread32(u32 value, volatile void _ jiomem *addr); 
void iowrite8(u8 value, volatile void _ iomem *addr); 
void iowritel6(ul6 value, volatile void _ iomem *addr); 
void iowrite32(u32 value, volatile void _ iomem *addr); 
/连续 的 IO 内 存 读 写 

void ioread8 rep(const volatile void _ iomem *addr, void *buffer,unsigned int count) ; 


void ioread16 rep(const volatile void  1omem *addr,void *buffer, unsigned int count) ; 
void ioread32 rep(const volatile void  1omem *addr,void *buffer, unsigned int count) ; 
void iowrite8 rep(const volatile void _ iomem *addr, void *buffer,unsigned int count) ; 
void iowritel6 rep(const volatile void _ iomem *addr,void *buffer, unsigned int count) ; 
void iowrite32 rep(const volatile void _ jiomem *addr,void *buffer, unsigned int count) ; 
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6.3.30 S3C6410X 看 门 狗 驱 动 程序 实例 

为 保证 当 系 统 出 现 异常 时 能 自动 重启 ， 处 理 嚣 中 均 提供 了 看 门 狗 功能 。 看 门 狗 单元 既 可 
以 产生 复位 信号 ， 也 可 被 用 作 一 个 普通 的 16 位 的 间隔 定时 器 来 产生 中 断 服务 。 图 6-4 是 
S3C6410X 的 看 门 狗 单元 的 原理 。 


Interrupt 


Reset Signal Generator 


RESET 


WTCON[15:8] WTCON[4:3] WICON[2] WTCON[0] 


图 6-4 S3C6410X 的 看 门 狗 单元 


看 门 狗 单 元 使 用 PCLK 作为 它 的 时 钟 源 。PCLK 时 钟 被 8bit 的 预 分 频 器 分 频 ， 产 生 相 应 
的 看 门 狗 定时 器 时 钟 ， 所 得 的 频率 被 再 次 分 频 ， 分 频 因子 可 以 选择 16、32、64 或 128。 看 门 
狗 定时 器 时 钟 频率 的 计算 公式 如 下 : 
看 门 狗 定时 器 时 钟 频率 = 1/(( PCLK / ( 预 分 频 值 + 1)/ 分 频 因 子 ) 
看 门 狗 单元 的 寄存 器 见 表 6-3。 


表 6-3 看 门 狗 单 元 的 寄存 器 


寄存 器 地 址 R/W 描述 复位 值 
WTCON 0x7E004000 R/W 看 门 狗 定时 器 控制 寄存 器 0x8021 
WTDAT 0x7E004004 R/W 看 门 狗 定 时 器 数据 寄存 器 0x8000 
WTCNT 0x7E004008 R/W 看 门 狗 定时 器 计数 寄存 器 0x8000 

WTCLRINT 0x7E00400C Ww 看 门 狗 定时 器 中 断 清除 寄存 器 
WTDAT 保存 看 门 狗 定 时 器 重 载 计 数值 。WTCNT 保存 看 门 狗 定 时 器 当前 的 值 。 


WTCLRINT 用 来 清除 看 门 狗 定 时 器 中 断 ， 写 入 任意 值 将 清除 中 断 。WTCON 各 位 的 具体 含 
义 见 表 6-4。 


表 6-4 WTCON 寡 存 器 


WTCON bit 说 明 初始 值 
Prescaler value [15:8] 预 分 频 值 ， 有 效 范围 为 0~2*-1 0x80 
Reserved [7:6] 常规 操作 下 为 00 00 
Watchdog timer [5] 看 门 狗 使 能 位 : 0= 禁 止 ，1= 使 能 1 
Clock select [4:3] 分 频 因子 选择 : 00:16; 01:32; 10:64 ; 11:128 00 
Interrupt generation [2] 中 断 使 能 位 : 0= 禁 止 ，1= 使 能 0 
Reserved [1] 常规 操作 下 为 0 0 
Reset enable/disable [0] 看 门 狗 定时 器 复位 信号 使 能 位 ; 0= 禁 止 ，1= 使 能 1 
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例 6.2 S3C6410X 看 门 狗 驱动 程序 实例 
代码 见 \samples\6hardsimple\6-2wdc。 核 心 代码 如 下 : 


#define WDC RESET ENABLE (1<<0) 
#define WDC INTERRUPT ENABLE (1<<2) 
#define WDC TIMER ENABLE (1««5) 


static void _ jiomem *s3c wdc base; 
struct simple dev *simple devices; 
static unsigned char simple inc=0; 
static int wdctimeout-0; 
int simple open(struct inode *inode, struct file *filp) 
1 
struct simple dev *dev; 
printk("simple open"); 
if(simple inc»0)return -ERESTARTSYS; 
simple inc++; 
dev = container of(inode-^i cdev, struct simple dev, cdev); 
filp-^»private data = dev; 
int tmp-((0x67««8)/(0x1««4)|WDC RESET ENABLE[WDC TIMER ENABLE; 
wdctimeout-0xFFFF; 
writel(wdctimeout, s3c wdc base + S3C64XX WDCNT); 
writel(tmp, s3c wdc base + S3C64XX WDCON); 
printk("S3C64XX WDCON 0x%x\n",readl(s3c wdc base + S3C64XX WDCON)); 
return 0; 
} 
/关闭 设备 
int simple release(struct inode *inode, struct file *filp) 
1 
simple inc--; 
return 0; 
} 
/看 门 狗 设 置 
int simple ioctl(struct inode *inode, struct file *filp,unsigned int cmd, unsigned long arg) 


1 


void user *argp = (void user *)arg; 
int user *p = argp; 
ifíecmd--WDIOC KEEPALIVE)// 喂 狗 


{ 
printk("S3C64XX WDDAT Ox%x\n",readl(s3c wdc base + S3C64XX WDDAT)); 
printk("S3C64XX WDCON O0x%x\n",readl(s3c wdc base + S3C64XX WDCON)); 
writel(wdctimeout, s3c wdc base + S3C64XX WDCNT); 
printk("S3C64XX WDCNT Ox%x\n",readl(s3c wdc base-- S3C64AXX WDCNT)); 
} 
if(cemd==WDIOC_SETTIMEOUT)// 设 置 超时 
{ 


//t_watchdog=0.0001s 
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j 


wdctimeout-(*p)* 10000; 
printk("wdctimeout?odW" ,wdctimeout); 
writel(wdctimeout, s3c wdc base + S3C64XX WDDAT); 


j 
return -EFAULT; 


struct file operations simple fops = { 


.owner = THIS_MODULE, 
.open= simple_open, 
Joctl = simple_ioctl, 


.Telease= simple release, 


int simple init module(void) 


s3c wdc base = ioremap(S3C64XX PA WDC,0Oxfp;/ 看 门 狗 寄 存 器 地 址 空间 映射 


if(s3c wdc base — NULL) 

1 
printk(KERN NOTICE "ioremap Error n"); 
result = -EINVAL; 
goto fail; 

j 

printk("simple init module"); 

return 0; 


RZANI P: 


int main(int argc, const char *argv[]) 


s 

1 

} 
应 用 

{ 

} 


应 用 程序 启 


int fd=open("/dev/watchdog",O WRONLY); 
if (fd==1) 
{ 
perror("watchdog"); exit(1); 
} 
int timeout =4; 
ioctl(fd, WDIOC SETTIMEOUT, &timeout); 
while(1) 
{ 
ioctl(fd, WDIOC KEEPALIVE, 0); 
sleep(1); 
} 
close(fd); 


狗 ， 则 系统 过 一 段 时 间 会 自动 重启 。 本 例 运 行 结 果 如 下 : 
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动 后 设置 了 喂 狗 超时 时 间 ， 随 后 不 断 进 行 喂 狗 。 假 如 应 用 程序 退出 ， 不 下 


[root@urbetter /homeļ]# insmod | demo.ko 


simple init module 


[root(Qurbetter /homel# mknod /dev/watchdog c 224 0 


[root(a)urbetter /homel# ./wdc 
simple open 

S3C64XX WDCON 0x6731 
wdctimeout40000 

S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
S3C64XX WDCNT 0x9c40 
S3C64XX WDDAT 0x9c40 
S3C64XX WDCON 0x6731 
AG 

[root(Q)urbetter /home]£ j? 
/关闭 程序 后 4 秒 系统 重启 


Is 


U-Boot 1.1.6 (May 11 2009 - 10:23:24) for SMDK6410 


LILLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLILLIL ILI 


e UT-S3C6410 Nand boot v0.18 
ds ShenZhen Urbetter Technology 


Tr Http://www.urbetter.com 
FKK KK KK KK K K 2K 2K K 2K K 2K K K 3K K FK 2K 2K K 2K K 3K 3K 3K 3K 2K FK K 2K K 3K K K K K 


6.4 EFH 


电 平 就 是 电压 的 范围 。 一 般 电 平 包 括 高 电 平和 低 


法 。 常 用 的 电 平 种 类 包括 TTL 电 平 、 
不 同 ，TTL 电 平 信号 用 1 

想 ， 一 般 对 于 输 

为 高 电 平 。 


BE; 


[pun 
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平 两 种 ， 这 种 分 类 是 按照 
CMOS 电 平 和 RS232 电 平 ， 各 种 电 平 规定 的 电压 犯 转 
H5V 等 价 于 逻辑 “1”"，0V 等 价 于 逻辑 “0”。 
出 ，<0.8V 为 低 电 平 ，>2.4V 为 高 电 


当然 实际 情况 没有 这 么 理 


二 进 制 的 方 


H 


对 于 输入 ，<1.2V HIRE 


HP, >2.0V 
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ET 


/ 管 脚 号 

#define S3C64XX GPA( nr) 
#define S3C64XX GPB( nr) 
#define S3C64XX GPC( nr) 
#define S3C64XX GPD( nr) 
#define S3C64XX GPE( nr) 
#define S3C64XX GPF( nr) 
#define S3C64XX GPG( nr) 
#define S3C64XX GPH( nr) 
#define S3C64XX  GPI( nr) 
#define S3C64XX GPJ( nr) 
#define S3C64XX GPK( nr) 
#define S3C64XX GPL( nr) 
#define S3C64XX GPM( nr) 
#define S3C64XX GPN( nr) 
#define S3C64XX GPO( nr) 
#define S3C64XX GPP( nr) 
#define S3C64XX GPQ( nr) 
//GPIO 操作 函数 


(S3C64XX GPIO A START + ( nr)) 
(S3C64XX GPIO B START + ( nr) 
(S3C64XX GPIO C START + ( nr) 
(S3C64XX. GPIO D START + ( nr)) 
(S3C64XX. GPIO E START + ( nr) 
(S3C64XX GPIO F START + ( nr)) 

(S3C64XX GPIO G START+ ( nr)) 
(S3C64XX GPIO H START + ( nr)) 
(S3C64XX GPIO I START + ( nr) 

(S3C64XX GPIO J START + ( nr) 

(S3C64XX GPIO K START + ( nr)) 
(S3C64XX. GPIO L START + ( nr) 
(S3C64XX. GPIO M START + ( nr) 
(S3C64XX. GPIO N START + ( nr) 
(S3C64XX. GPIO O START + ( nr) 
(S3C64XX. GPIO P START + ( nr) 

(S3C64XX GPIO Q START + ( nr) 


int s3c gpio cfgpin(unsigned int pin, unsigned int config); 


ints3c gpio cfgpin range(unsigned int start, unsigned int nr,unsigned int cfg); 


ints3c gpio setpull(unsigned int pin, samsung gpio pull t pull); 


void gpio set value(unsigned gpio, 
int gpio get value(unsigned gpio); 


int value); 


6.4.44 S3C6410X LED 驱动 程序 实例 


S3C6410X LED 人 灯 电 路 原理 如 图 


BJ. S3C6410X 内 核 中 提供 了 一 些 GPIO 接口 | 


6-5 所 示 。 四 个 LED 灯 分 别 接 到 GPM0 一 GPM3 | 


VDD IO 
o 
wu Z 
LED R69 330R 
d D6805 VY Ro4o2 | 
nLED1 ` R70 100K pA D3 
NN LED R71 330R 
PONS 4 sor2s,| — os ^v R0402 
R72 100K Q3 D4 
nLED2 X> VV NR 1 8050 MN LED Ra 330R | 
a| SOT-23 D0805 R0402 
nLED3 TAAN — 100 1 8050 v LED R75 330R 
insons SOT-23 Moos vvv R0402 
R76 100K Q5 
nLED4 5» V^ V Ro402 1 8050 
SOT-23 
图 6-5 S3C6410X LED 4] JE 
15) 6.3 S3C6410X LED 驱动 程序 实例 


代码 见 \samples\6hardsimple\6-4led。 核 心 代码 如 下 : 
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#define S3C64XX GPMO OUTPUT (0x01 << 0) 
#define S3C64XX GPMI OUTPUT (0x01 << 4) 
define S3C64XX GPM2 OUTPUT (0x01 «« 8) 
define S3C64XX GPM3 OUTPUT (0x01 << 12) 
/WLED 管 脚 设置 


#define LED_SI OUTI s3c gpio cfgpin(S3C64XX GPM(0),53C64XX GPMO OUTPUT) 
#define LED SI OUT2 s3c gpio cfgpin(S3C64XX GPM(1),S3C64XX GPM1 OUTPUT) 
#define LED SI OUT3 s3c gpio cfgpin(S3C64XX GPM(2),S3C64XX GPM2 OUTPUT) 
#define LED SI OUT4 s3c gpio cfgpin(S3C64XX GPM(3),S3C64XX GPM3 OUTPUT) 


Ira gens 


T 
fe 


#define LED SI H(1) raw writel( raw readl(S3C64XX GPMDAT)/(1««1),S3C64XX GPMDAT) 
#define LED SI LO raw writel( raw read((S3C64XX GPMDAT)&(—(1««))S3C64XX. GPMDAT) 
int simple ioctl(struct inode *inode, struct file *filpunsigned int cmd, unsigned long arg) 


1 
void user *argp = (void user *)arg; 
int *p-(int*)argp; 
ifícmd--COMMAND LEDON) 
1 
LED SI L(*p); 
printk(" raw readl(S3C64XX GPMDAT)=0x%x\n", 
. raw readl(S3C64XX GPMDAT)); 
return 0; 
} 
这 cmd==COMMAND LEDOFF) 
1 
LED SI H(*p); 
printk(" raw readl(S3C64XX GPMDAT)=0x%x\n", 
. raw readl(S3C64XX GPMDAT)); 
return 0; 
} 
return -EFAULT; 
} 
struct file operations simple fops={ 
.owner = THIS MODULE, 
.open- simple open, 
Joctl = simple ioctl, 
release — simple release, 


js 


上 面 的 LED SI H 5 LED SI L 两 个 宏 也 可 直接 调用 gpio set value 函数 ， 
6hardsimple\6-4led_2: 


#define LED SI H(i) gpio set value(S3C64XX GPM(1),1) 
#define LED SI L(1) gpio set value(S3C64XX GPM(1),0) 


应 用 层 参考 代码 如 下 : 


具体 见 \samples'\ 
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void main() 
{ 
int fd; 
int i—2; 
char data[256]; 
int retval; 
fd=open("/dev/led",O RDWR); 
if(fd——-1) 
i 
perror("error open"); 
exit(-1); 
j 
printf("open /dev/led successfully"); 
forG=0;i<4;i++) 
{ 
retval-ioctl(fd, COMMAND LEDON,&i); 
if(retval-——-1) 
{ 
perror("ioctl LEDON error\n"); 
exit(-1); 
} 
sleep(1); 
retval-ioctl(fdj. COMMAND LEDOFF,&i); 
if(retval-——-1) 
{ 
perror("ioctl LEDOFF errorn"); 
exit(-1); 


} 
close(fd); 


j 


本 例 运 行 结果 如 下 : 


[root@urbetter /homel# insmod demo.ko 
[root@urbetter /homel# mknod /dev/led c 224 0 
[root(Qurbetter /home]# ./test 

open /dev/led successfully 

. raw readl(S3C64XX GPMDAT)-0xle 
. raw readl(S3C64XX GPMDAT)-0x1f 
. raw readl(S3C64XX GPMDAT)-0x1d 
. raw readl(S3C64XX GPMDAT)-0x1f 
. raw readl(S3C64XX GPMDAT)-0x1b 
. raw readl(S3C64XX GPMDAT)-0x1f 
. raw readl(S3C64XX GPMDAT)-0x17 
. raw readl(S3C64XX GPMDAT)-0x1f 
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运行 过 程 中 将 会 看 到 LED 灯 依 次 闪 灭 。 
6.4.2 ”扫描 型 按键 驱动 程序 实例 
S3C6410X 按键 电路 原理 如 图 6-6 所 示 。 


p -x— 


$63 简单 硬件 设备 驱动 程序 


六 个 按钮 分 别 接 到 S3C6410X 的 GPNO—GPNS | 


[lo 


KEYINT1 


KEYINT2 


KEYINT3 


KEYINTA 


KEYINTS 


KEYINT6 


6-6 S3C6410X 按键 电路 原理 


图 
例 6.4 扫描 型 按键 驱动 程序 实例 
代码 见 \samples\6hardsimple\6-5scanbutton。 核 心 代码 如 下 : 
void initButton(void) 
{ 


S3c gpio cfgpin(S3C64XX GPN(0),0); 
S3c gpio cfgpin(S3C64XX GPN(1),0); 
S3c gpio cfgpin(S3C64XX GPN(2),0); 
S3c gpio cfgpin(S3C64XX GPN(3),0); 
S3c gpio cfgpin(S3C64XX GPN(4),0); 
S3c gpio cfgpin(S3C64XX GPN(5),0); 


j 


ssize t button read(struct file *filp, char — user *buf, size t count, loff t *f pos) 


1 


int sum-1; 


struct button dev *dev = filp-^private data; 


int value= raw readl((S3C64XX G 
value-value&Ox3F; 


PNDAT); 


if (copy to user(buf,&value,sizeof(int))) 


1 
sum—-EFAULT; 


j 
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return sum; 

j 

struct file operations button fops = { 
.OWner = THIS_MODULE, 


read = button read, 
open = button open, 
release — button release, 

h 

int button init module(void) 

1 

initButton(); 

} 


应 用 层 代 码 如 下 : 


int offset[]- (Ox3E,0x3D,0x3B,0x37,0x2F,0x1F); 


void main(void) 
1 

int fd; 

int i; 


int retval-0,oldvalue-0; 
fd—open("/dev/fgj",O. RDWR); 


if(fd==-1) 
{ 
perror("error open"); 
exit(- 1); 
} 
printf("open /dev/fgj successfully"); 
while(1) 
1 
j-read(fd,&retval,4); 
if(i>0) 
{ 
if(retval!-oldvalue) 
1 
for(i=0;i<6;i++) 
{ 
if(offset[1]—retval) 
1 
printf("key9od is pressed" 1-1); 
} 
} 
j 
oldvalue-retval; 
} 
usleep(10); 
} 
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close(fd); 
} 


本 例 运行 结果 如 下 : 


[root@urbetter /homel#insmod demo.ko 

[root@urbetter /homel#mknod /dev/fgj c 224 0 
[root@urbetter /home|# ./test 

open /dev/fgj successfully /此 时 依次 按 下 不 同 的 按钮 
key2 is pressed 

keyl is pressed 

key4 is pressed 

key3 is pressed 

key5 is pressed 

key6 is pressed 


6.5 ”硬件 中 断 处 理 


6.5.1. 硬件 中 断 处 理 原理 

从 物理 学 的 角度 看 ， 硬 件 中 断 是 一 种 电信 号 ， 由 硬件 设备 产生 ， 并 直接 送 入 中 断 控制 器 
输入 引 脚 上 ， 再 由 中 断 控制 器 向 处 理 器 发 送 相应 的 信号 。 处 理 器 一 旦 检测 到 该 信号 ， 便 中 断 
自己 当前 正在 处 理 的 工作 ， 转 而 去 处 理 中 断 。 图 6-7 是 中 断 处 理 原理 图 。 


— —[RQO 


Interrupt Controller 


— —IRQ63 


图 6-7 ”中断 处 理 原 理 


如 果 中 断 处 理 过 程 非常 复杂 ， 可 以 分 成 两 部 分 : 上 半 部 Ctop half) 和 下 半 部 (bottom 
half)。 上 半 部 完成 一 些 急 需 处 理 的 事务 ， 如 从 硬件 读 取 信息 ， 下 半 部 完成 余下 的 复杂 的 运算 
或 逻辑 处 理 。 下 半 部 是 可 中 断 的 ， 而 上 半 部 是 不 可 中 断 的 ， 处 理 完毕 立即 返回 。Linux 中 的 
中 断 下 半 部 包括 软 中 断 、tasklet 机 制 和 工作 队列 等 。 

Linux 内 核 中 的 中 断 请 求 队列 用 irq dese 结构 描述 : 


m 


struct irq. desc { 
unsigned int irq; /中 断 号 
struct timer rand state *timer rand state; 
unsigned int ^*kstat irqs; 每 个 CPU 的 中 上 断 状态 
#ifdef CONFIG INTR REMAP 


struct irq 2 iommu *irq 2 1ommu; 
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#endif 
irq flow handler t handle_irq; /高 级 中 断 处 理 
struct irq_chip *chip; 
struct msi desc *msi desc; 
void *handler data; 
void *chip data; 
struct irqaction *action; [*IRQ 服务 列表 */ 
unsigned int status; /*IRQ 状态 */ 
unsigned int depth; PIRRE, MF irq disable0*/ 
unsigned int wake depth; /* YRR, HF set irg wake()*/ 
unsigned int irq count; 
unsigned long last unhandled; 
unsigned int irgs unhandled; /未 处 理 的 中 断 
raw spinlock t lock; 
#ifdef CONFIG SMP 
cpumask var t affinity; 
unsigned int node; 
#ifdef CONFIG GENERIC PENDING IRQ 
cpumask var t pending mask; 
#endif 
#endif 
atomic t threads active; 
wait queue head t wait for threads; 
#ifdef CONFIG PROC FS 
struct proc dir entry *dir; jproc 路 径 
#endif 
const char *name; /名 称 
} cacheline internodealigned in smp; 


struct irq desc irq desc[NR. IRQS]; 


IRQ 服务 列表 的 结构 描述 为 : 


struct irqaction { 
irq handler t handler; /设备 中 断 处 理 函 数 
unsigned long flags; 
const char *name;/ 设 备 名 
void *dev id; /设备 ID 
struct irqaction *next; 
int irq; /中 断 号 


struct proc dir entry *dir; jproc 路 径 
irq handler t thread fn; // 中 断后 处 理 线程 


struct task struct *thread; 
unsigned long thread flags; 
5h 


不 同 的 设备 对 应 的 中 断 都 用 一 个 唯一 的 整 型 数据 标识 ， 这 个 整 型 数据 叫 作 


request irq 函数 用 于 申请 
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int request irq(unsigned int irq, irq handler t handler, unsigned long flags,const char *name, void *dev); 


参数 irq 表示 所 要 申请 的 硬件 中 断 号 。name 为 中 断 名 称 。dev 为 设备 参数 。handler 
中 断 处 理 函 数 ， 中 断 产生 时 系统 会 调用 该 函数 : 


typedef irqreturn_ t (*irq handler t)(int, void *); 


irq handler t 的 第 一 个 参数 为 中 断 号 。 


flags 是 申请 时 的 选项 ， 它 决定 中 断 处 理 


#define IROF DISABLED 

#define IROF SAMPLE RANDOM 
#define IRQF SHARED 

#define IRQF PROBE SHARED 
#define IRQF TIMER 

#define IRQF PERCPU 

#define IRQF NOBALANCING 
#define IRQF IRQPOLL 

#define IRQF ONESHOT 


P 断 触发 方式 包括 以 下 类 型 : 


H 


#define IRQF TRIGGER NONE 
#define IRQF TRIGGER. RISING 
#define IRQF TRIGGER. FALLING 
#define IRQF TRIGGER HIGH 
#define IRQF TRIGGER LOW 


P 断 处 理 程序 的 返回 值 有 三 种 : 


ini 


enum irqreturn 1 


程序 的 一 些 特性 : 


0x00000020 ” W 处 理 中 断 时 关闭 
0x00000040 ”W/W 对 内 核 蚁 池 有 贡献 
0x00000080 ”/W/ 多 设备 共享 中 断 
0x00000100 

0x00000200 /定时 器 中 断 
0x00000400 

0x00000800 “V/ 不 受 中 断 平 衡 影响 
0x00001000 

0x00002000 


TH 


E 


0x00000000 ”// 未 设置 触发 方式 
0x00000001  //EJH& 
0x00000002 // FBX% 
0x00000004 “ /高 电 平 
0x00000008 “V 低 电 平 


IRQ NONE, / 非 本 设备 中 断 
IRQ HANDLED, /中 断 处 理 完 毕 


IRQ WAKE THREAD， /唤醒 处 理 线程 ， 用 于 以 线程 来 处 理 中 断后 半 部 的 情况 


lis 


ER 
5 


int request threaded irq(unsigned int irq, irq. handler t handler, 


为 


申请 中 断 时 如 果 需 要 为 设备 建立 一 个 中 断后 处 理 线程 ， 可 以 使 用 request threaded irq 


irq handler tthread fn, unsigned long irgflags,const char *devname, void *dev 1d) 


handler 为 主 处 理 函 数 ，thread fn 为 中 断 处 理 线程 函数 。 如 果 中 断 主 处 理 函 数 handler 


回 IRQ WAKE THREAD， 则 会 唤醒 
数 irq_default primary handler: 


返 


断 线 程 。 假 如 handler 为 空 ， 则 采用 默认 的 主 处 到 


static irqreturn tirq default primary handler(int irq, void *dev 1d) 


{ 
return IRQ WAKE THREAD; 


MS 
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j 
free irq 函数 用 来 释放 一 个 中 断 : 


void free irq(unsigned int irq, void *dev id); 


ARM 体系 中 处 理 中 断 的 函数 为 asm do IRQ. asm do IRQ 函数 在 entry-macro-multi.S 
中 被 调用 : 


ini 


T 


.macro arch irq handler default 
get irqnr preamble r6, lr 
]: get irqnr and base r0, r2, r6, lr 


movne rl, sp 

@ 

(à) routine called with r0 = irq number, r1 = struct pt regs * 
@ 


badrne lr, 1b 
bne asm_do_IRQ 


asm do IRQ 定义 如 下 : 


void arch do IRQ(unsigned int irq, struct pt regs *regs) 


1 
struct pt regs *old regs = set irq regs(regs); 
irq enter(); 
generic handle irq(irq); 
irq exit(); 
set irq regs(old regs); 
} 


函数 。 


generic handle irq 函数 调用 了 generic handle irq desc 函数 ， 进 而 调用 了 中 断 处 型 


n 


int generic handle irq(unsigned int irq) 


1 
struct irq desc *desc = irq to desc(irq); 
if (!desc) 
return -EINVAL; 
generic handle irq desc(desc); 
return 0; 
j 
static inline void generic handle irq desc(struct irq. desc *desc) 
{ 
desc->handle irq(desc); 
} 


handle irq 函数 最 终 会 调用 irqaction 结构 的 handler 成 员 ， 也 就 是 request irq 函数 注册 的 
中 断 处 理 函数 。 在 中 断 上 下 文中 ， 有 一 些 需 要 注意 的 地 方 。 中 断 处 理 函 数 应 该 快速 退出 并 让 
出 处 理 器 ， 不 能 与 用 户 空间 交换 数据 ， 不 能 调用 能 引起 睡眠 的 函数 ， 并 应 确保 其 内 部 不 会 触 


hmi 


T 
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发 阻塞 等 待 。 在 中 断 处 理 函数 中 保护 临界 区 ， 不 能 使 用 互 斥 体 ， 因 为 它们 可 能 导致 睡眠 ， 真 
正 需要 保护 临界 区 的 时 候 应 该 使 用 日 旋 锁 。 中 断 处 理 函 数 个 必 是 可 重用 的 。 当 其中 断 被 执行 
的 时 候 ， 在 它 返 回 之 前 ， 相 应 的 耻 Q 都 被 禁止 了 。 因 此 ， 与 进程 上 下 文 代码 不 同 的 是 ， 同 一 
中 断 处 理 函 数 的 不 同 实例 不 可 能 同时 运行 在 多 个 处 理 器 上 。 另 外 中 断 处 理 函 数 可 以 被 更 高 优 
先 级 IRQ 的 中 断 处 理 函 数 打 断 。 
禁止 与 允许 中 断 的 函数 包括 : 
void disable irq(int irq); // 禁 止 单个 中 断 ， 等 待 成 功 返 世 
void disable irq nosync(int irq); /禁止 单个 中 断 ， 不 等 待 返回 
void enable irq(int irq); /人 允许 单个 中 断 
void local irq_save(unsigned long flags); /禁止 所 有 中 断 ， 并 保存 标志 
void local irq diable(void); /禁止 所 有 中 断 
void local irq restore(unsigned long flags);V/ 使 能 所 有 中 断 ， 并 恢复 标志 
void loval irq_enable(void); /使 能 所 有 中 断 
6.5.2 中断 型 按键 驱动 程序 实例 
S3C6410X 的 中 断 控制 单元 由 2 个 向 量 中 断 控 制 嚣 (VIC〉 和 2 个 信任 区 中 断 控 制 器 
(TZIC) 组 成 。S3C6410X 的 中 断 控 制 单元 可 文 持 64 个 中 断 源 。S3C6410X 的 中 断 控制 单元 具 
有 中 断 优 先 级 可 编程 、 文 持 中 断 屏蔽 、 文 持 快 中 断 和 普通 中 断 、 文 持 软 中 断 等 特点 。 


H 


例 6.5 
本 例 的 : 


PAL RED 
EER SH 


K 动 程序 实例 
E 同 例 6.4. ARIS WNsamplesV6hardsimple 6-6interruptbutton. Tz 


static int irqArray[6]- 

1 
S3C EINT(0),S3C EINT(1),S3C EINT(2), 
S3C EINT(3),S3C EINT(4),S3C EINT(5) 

h 

struct button dev *button devices; 

static unsigned char button inc-0; 

static int flag = 0; 

struct timer list polling timer; 

static unsigned long polling jffs=0; 

/ 管 脚 初始 化 

void initButton(void) 


1 


IL 


s3c gpio cfgpin(S3C64XX GPN(0),S3C64XX GPNO EINTO0); 
s3c gpio cfgpin(S3C64XX GPN(1),53C64XX GPNI EINTI1); 
S3c gpio cfgpin(S3C64XX GPN(2),S3C64XX GPN2 EINT2); 
S3c gpio cfgpin(S3C64XX GPN(3),S3C64XX GPN3 EINT3); 
S3c gpio cfgpin(S3C64XX GPN(4),S3C64XX GPN4 EINT4); 
S3c gpio cfgpin(S3C64XX GPN(5),53C64XX GPNS EINT5); 
/取消 上 拉 
S3c gpio setpull(S3C64XX GPN(0), S3C GPIO PU 
S3c gpio setpull(S3C64XX GPN(1), S3C GPIO PU 


LL NONE); 
LL NONE); 


CAU P: 
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s3c gpio setpull(S3C64XX GPN(2), S3C GPIO PULL NONE); 
S3c gpio setpulllS3C64XX GPN(3), S3C GPIO PULL NONE); 
S3c gpio setpull(S3C64XX GPN(4), S3C GPIO PULL NONE); 
S3c gpio setpull(S3C64XX GPN(5), S3C GPIO PULL NONE); 
/设置 中 断 触发 类 型 
s3c irq eint set type(0, IRO TYPE EDGE FALLING); 
S3c irq eint set type(1, IRQ TYPE EDGE FALLING); 
S3c irq eint set type(2, IRQO TYPE EDGE FALLING); 
s3c irq eint set type(3, IRO TYPE EDGE FALLING); 
S3c irq eint set type(4, IRQO TYPE EDGE FALLING); 
s3c irq eint set type(5, IRO TYPE EDGE FALLING); 
/打开 中 断 掩 码 


S3c irq eint unmask(0); 


S3c irq eint unmask(1); 
S3c irq eint unmask(2); 
S3c irq eint unmask(3); 
S3c irq eint unmask(4); 
S3c irq eint unmask(5); 


j 
/中 断后 半 段 处 理 
void polling handler(unsigned long data) 
{ 
int code=-1; 
int i; 
code= raw readl(S3C64XX GPNDAT); 
code-code&Ox3F; 
for (i = 0; i <6; i++) 
{ 
enable irq(irgArray[i]); 
j 
if(code>=0) 
{ 
/避免 中 断 连 续 出 现 
if((jiffies-polling jffs)>100) 
1 
polling jffs-jiffies; 
/获取 键盘 值 
button devices->key=(unsigned char)code; 
printk("get key %u\n",button _ devices->key); 
flag= 1; 
wake up interruptible(&(button devices-^wq)); 
} 
j 
j 
/中 断 处 理 函 数 


static irqreturn t simplekey interrupt(int irq, void *dummy, struct pt regs *fp) 
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int i; 
for (i = 0; i <6; i++) 
1 
disable irq(irqArray[i]); 
j 
polling timer.expires — jiffies + HZ/5; 
add timer(&polling timer); 
return IRO HANDLED; 
j 


A op» 
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ssize t button read(struct file *filp, char — user *buf, size t countloff t *f pos) 


1 
struct button dev *dev = filp-^private data; 
int sum=0; 
if(flag--1) 
{ 
flag = 0; 
sum-1; 
if (copy to user(buf,&dev-^key,1)) 
{ 
sum=-EFAULT; 


else 
if (filp->f flags & O NONBLOCK) 
{ 


return -EAGAIN; 


else 


if(wait event interruptible(dev-wq, flag != 0))// 等 待 数据 就 绪 


{ 
retum - ERESTARTSYS; 


} 
flag = 0; 
sum=1; 
if (copy to user(buf,&dev->key,1)) 
1 
sum—--EFAULT; 


j 


return sum; 


j 


unsigned int button poll(struct file *filp, poll table *wait) 


ln 


TE 


事件 
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1 
struct button dev *dev = filp-^private data; 
poll wait(filp, &dev->wq, wait); 
让 (flag==1)/ 数 据 准 备 好 
return POLLIN | POLLRDNORM; 
return 0; 
j 


struct file operations button fops = 1 
.OWner = THIS MODULE, 


read — button read, 
open = button open, 
.poll- button poll, 
release — button release, 

5 

int button init module(void) 

1 

initButton(); 

for (i= 0; i <6; i++) 

1 


if (request irq(irgArray[1], &simplekey interrupt, 0, "simplekey", NULL)) 
1 


printk("request button irq failed! n"); 


return -1; 

j 

j 
init waitqueue head(&button devices-^wq); 
init timer(&polling timer); 
polling timer.data = (unsigned long)0; 
polling timer.function — polling handler; 
return 0; 

j 


应 月 
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刁 采 用 了 select 模型 ， 参 考 代 人 码 如 下 : 


unsigned char offset[]- (Ox3E,0x3D,0x3B,0x37,0x2F,0x1F]; 
int main(void) 
1 
int buttons fd; 
int i-0; 
unsigned char key value; 
fd set rds; 
buttons fd = open("/dev/buttons", 0); 
if (buttons fd < 0) 
1 
perror("open device buttons"); 
exit(1); 


/申请 中 断 ， 中 断 类 型 在 initButton 函数 中 设置 ， 此 处 未 设置 中 断 触 发 标志 
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} 
while(1) 
1 
int ret; 
FD ZERO(&rds); 
FD SET(buttons fd, &rds); 
ret — select(buttons fd--1, &rds, NULL, NULL, NULL); 
if (ret « 0) 
{ 
perror("select"); 
exit(1); 
j 
else if (ret — 0) 
{ 
printf("select timeout.\n"); 
} 
else if (FD ISSET(buttons fd, &rds)) 
i 
int ret = read(buttons fd, &key value, sizeof(key value)); 
if (ret != sizeof(key value)) 
{ 
if (errno != EAGAIN) 
perror("read buttons\n"); 
continue; 


else 


for(i=0;i<6;i++) 
{ 
if(offset[i]=—key_value) 
{ 
printf("key%d is pressed\n",i+1); 


} 
close(buttons fd); 
return 0; 


} 
本 例 运行 结果 如 下 : 


[root@urbetter /homel# insmod demo.ko 
[root(Qurbetter /homel# mknod /dev/buttons c 224 0 
[root(a)urbetter /homel# ./read 

/此 时 依次 按 下 不 同 的 按钮 
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get key 61 
key2 is pressed 
get key 62 
keyl is pressed 
get key 55 
key4 is pressed 
get key 59 
key3 is pressed 
get key 63 

get key 31 
key6 is pressed 
get key 47 
key5 is pressed 


6.6 看 门 狗 驱动 架构 


上 面 的 看 门 狗 例 程 是 用 来 演示 寄存 器 读 写 的 。 实 际 上 Linx 内 核 提 供 了 


通用 的 看 门 狗 驱 


动 架构 。Linux 内 核 中 看 门 狗 驱 动 在 /drivers/watchdog 目录 。 看 门 狗 设备 结构 如 下 : 


struct watchdog device { 
int id; 
struct device *parent; 
const struct attribute group **groups; 
const struct watchdog info *info; 
const struct watchdog ops *ops; // 看 门 狗 操 
unsigned int bootstatus; 
unsigned int timeout; 
unsigned int min timeout; 
unsigned int max timeout; 
struct notifier block reboot nb; 
struct notifier block restart nb; 
void *driver data; 
struct watchdog core data *wd data; 
unsigned long status; 
struct list head deferred; 


as 
注册 与 注销 看 门 狗 驱 动 的 函数 如 下 : 


/看 门 狗 信 ， 


int watchdog register device(struct watchdog device *wdd); 


void watchdog unregister device(struct watchdog device *wdd); 


看 门 狗 设备 有 一 个 重要 的 参数 ， 即 看 门 狗 操作 结构 ， 定 义 如 下 : 


struct watchdog ops { 
struct module *owner; 


庶 强 制 实 现 的 操作 */ 
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int (*start)(struct watchdog device *); 
int (*stop)(struct watchdog device *); 
ORERE, 
int (*ping)(struct watchdog device *); 
unsigned int (*status)(struct watchdog device *); 
int (*set timeout)(struct watchdog. device *, unsigned int);// 设 置 超时 
unsigned int (*get timeleft)(struct watchdog device *); 
int (*restart)(struct watchdog device *); 
long (*ioctl)(struct watchdog device *, unsigned int, unsigned long); 
h 
看 门 狗 设备 层 代 码 见 watchdog devc。 调 用 watchdog register device 函数 会 注册 一 个 以 
/dev/ watchdog 为 节点 的 设备 。 


int watchdog dev register(struct watchdog device *wdd) 
1 
struct device *dev; 
dev t devno; 
int ret; 
devno = MEKDEV(MAJOR(watchdog devt), wdd->id); 
ret = watchdog cdev register(wdd, devno); 
if (ret) 
return ret; 
dev = device create with groups(&watchdog class, wdd->parent, 
devno, wdd, wdd->groups,"watchdog%d", wdd->id); 
if (IS ERR(dev)) { 
watchdog cdev unregister(wdd); 
return PTR. ERR(dev); 
j 
return ret; 


j 


中 watchdog cdev register 函数 会 调用 misc. register 函数 注册 一 个 杂项 设备 驱动 : 


static const struct file operations watchdog fops={ 


.owner = THIS MODULE, 
write — watchdog write, 
unlocked ioctl — watchdog. ioctl, 
.open — watchdog open, 
release — watchdog release, 
h 
static struct miscdevice watchdog miscdev = ( 
minor = WATCHDOG MINOR, 
.name = "watchdog", 
.fops = &watchdog fops, 
h 


misc register(&watchdog miscdev); 
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杂项 设备 驱动 是 一 种 特殊 的 字符 设备 驱动 ， 其 主 设备 号 为 10， 次 设备 号 通过 结构 体 
miscdevice 中 的 minor 成 员 来 设置 ，/dev 目录 下 的 设备 节点 也 会 自动 创建 。 这 里 读者 看 到 了 
熟悉 的 人 e_operations 结构 ， 这 就 是 通用 的 看 门 狗 应 用 层 访问 接口 。 

S3C6410X 的 看 门 狗 与 S3C2410 是 一 样 的 。 下 面 结合 内 核 中 的 s3c2410_wdc.c 文件 做 一 
些 说 明 : 


static const struct watchdog info s3c2410 wdt ident = ( 
.options = OPTIONS, 
.firmware version = 0, 
.identity=  "S3C2410 Watchdog", 
je 
static struct watchdog ops s3c2410wdt ops = ( 
.owner - THIS MODULE, 
.Start = s3c2410wdt start, 
.Stop = s3c2410wdt stop, 
.ping = s3c2410wdt keepalive, 
.set timeout = s3c2410wdt set heartbeat, 
restart — s3c2410wdt restart, 
n 
static struct watchdog device s3c2410 wdd = ( 
.info = &s3c2410 wdt ident, 
ops = &s3c2410wdt ops, 
.timeout = CONFIG. S3C2410 WATCHDOG DEFAULT TIME, 
je 
/注册 watchdog 设备 
wdt->wdt device = s3c2410 wdd; 
ret = watchdog register device(&wdt-^wdt device); 


6.7 RTC 驱动 


嵌入 式 系 统一 般 有 两 个 时 间 ， 一 个 是 RTC 时 间 ， 一 个 是 Linux 系统 时 间 。RTC 时 间 存 
储 在 RTC 控制 器 中 ， 系 统 断 电 后 通过 电池 供电 ， 保 证 系统 下 次 重新 上 电 时 能 读 到 正确 的 时 
间 。 通 常 在 系统 启动 脚本 中 读 取 RTC 时 间 ， 并 将 RTC 时 间 设 置 为 系统 时 间 。Linux 中 的 


date 命令 是 用 来 读 取 与 设置 系统 时 间 的 ;而 hwclock 命令 是 用 来 读 取 与 设置 RTC 时 间 的 。 
注册 与 注销 RTC 驱动 : 


Æ 


struct rtc device *devm rtc device register(struct device *dev,const char *name, 


const struct rtc class ops *ops,struct module *owner); 
RTC 设备 类 的 操作 接口 如 下 : 


struct rtc class ops { 
int (*open)(struct device *); 
void (*release)(struct device *); 
int (*ioctl)(struct device *, unsigned int, unsigned long); 
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int (*read time)(struct device *, struct rtc time *); 

int (*set time)(struct device *, struct rtc time *); 

int (*read alarm)(struct device *, struct rtc wkalrm *); 

int (*set alarm)(struct device *, struct rtc wkalrm *); 

int (*proc)(struct device *, struct seq file *); 

int (*set mmss64)(struct device *, time64 t secs); 

int (*set mmss)(struct device *, unsigned long secs); 

int (*read callback)(struct device *, int data); 

int (*alarm irq enable)(struct device *, unsigned int enabled); 


Js 
RTC 驱动 也 包含 一 个 通用 的 设备 层 ， 负 责 创建 /dev/rte 设备 ， 并 向 应 用 层 提供 统一 的 
RTC 操作 接口 。 


static const struct file operations rtc dev fops = { 


„owner = THIS MODULE, 
.llseek = no llseek, 

read —rtc dev read, 

.poll —rtc dev poll, 
unlocked ioctl — rtc dev ioctl, 
.open —rtc dev open, 
release —rtc dev release, 
.fasync —rtc dev fasync, 


js 
这 里 以 内 核 中 RTC. RD TIME 命令 的 实现 为 例 说 明 RTC 驱动 的 设计 ， 代 人 码 如 下 : 


static long rtc dev ioctl(struct file *file,unsigned int cmd, unsigned long arg) 


1 
switch (cmd) ( 
case RTC RD TIME: 
mutex unlock(&rtc-^ops lock); 
err — rtc read time(rtc, &tm); 
if (err « 0) 
return err; 
if(copy to user(uarg, &tm, sizeof(tm))) 
err = -EFAULT; 
return err; 
j 
j 
intrtc read time(struct rtc. device *rtc, struct rtc time *tm) 
1 
int err; 


err = mutex lock interruptible(&rtc-^ops lock); 
if (err)return err; 

err= rtc read time(rtc, tm); 

mutex unlock(&rtc-^ops lock); 


return err; 
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} 
static int rtc read time(struct rtc. device *rtc, struct rtc time *tm) 
1 
Int err; 
if (!Irtc-^ops) 
err = -ENODEV; 
else if (!rtc-^ops-^read time) 
err = -EINVAL; 
else ( 
memset(tm, 0, sizeof(struct rtc time)); 
err = rtc->ops->read time(rtc-^dev.parent, tm); 
if (err < 0) ( 
dev dbg(&rtc-^dev, "read time: fail to read: %d\n", 
err); 
return err; 
} 
err=rtc valid tm(tm); 
if (err « 0) 
dev dbg(&rtc-^dev, "read time: rtc time isn't valid n"); 
} 
return err; 
} 


可 见 Linux 内 核 已 经 实现 了 RTC 设备 的 文件 操作 层 ， 具 体 的 设备 驱动 层 只 需要 实现 
RTC 设备 类 的 操作 接口 。 

S3C6410X 的 RTC 单元 能 够 在 系统 掉 电 的 情况 下 使 用 备用 电池 工作 。RTC 单元 的 时 间 
数据 包含 秒 、 分 、 小 时 、 日 、 月 、 年 。RTC 单元 使 用 外 部 的 32.768kHz 的 晶振 ， 并 可 提供 报 
警 功能 。RTC 单元 支持 半年 ， 支 持 RTOS 内 核 所 需 的 毫秒 级 别 的 时 钟 中 断 。S3C6410X 的 
RTC 驱动 在 /drivers/rtc/rte-s3c.c 中 。 下 面 看 看 该 文件 中 read. time 函数 的 实现 ; 


static const struct rtc class ops s3c rtcops- ( 
read time — —s3c rtc gettime, 
.set time = s3c rtc settime, 


read alarm = s3c rtc getalarm, 


.Set alarm — —s3c rtc setalarm, 

.proc = s3c rtc proc, 

.alarm irq enable = s3c rtc setaie, 
h 
static int s3c rtc. gettime(struct device *dev, struct rtc time *rtc tm) 
1 


struct s3c rtc *info = dev get drvdata(dev); 
unsigned int have retried — 0; 
S3c rtc enable clk(info); 

retry get time: 
rtc tm-^tm min = readb(info-^base + S3C2410 RTCMIN); 
rtc tm-^tm hour = readb(info-^base + S3C2410 RTCHOUR); 
rtc tm-^tm mday = readb(info-^base + S3C2410 RTCDATB); 


150 


如 果 


j 


要 让 S3C6410X 的 RTC 5 


^A -x— 


563 


rtc tm-^tm mon = readb(info-^base + S3C2410 RTCMON); 
rtc tm-^tm year = readb(info-^base + S3C2410 RTCYEAR); 
rtc tm-^tm sec = readb(info-^base + S3C2410 RTCSEC); 
UMREN 0, HRKI MAER 
if (rtc_tm->tm_sec == 0 && !have_retried) { 

have retried = 1; 


goto retry get time; 
j 
rtc tm->tm sec = bcd2bin(rtc tm-^tm sec); 
rtc tm-^tm min = bcd2bin(rtc tm-^tm min); 
rtc tm-^tm hour = bed2bin(rtc tm-^tm hour); 
rtc tm->tm mday = bcd2bin(rtc tm-^tm mday); 
rtc tm-^tm mon = bcd2bin(rtc tm->tm mon); 
rtc tm-^tm year = bcd2bin(rtc tm->tm year); 
S3c rtc disable clk(info); 
rtc tm-^tm year += 100; 
dev dbg(dev, "read time %04d.%02d.%02d %02d:%02d:%02d\n", 


1900 + rtc tm-^tm year, rtc tm-^tm mon, rtc tm->tm mday, 


rtc tm-^tm hour, rtc tm-^tm min, rtc tm->tm sec); 


rtc tn-^tm mon -= 1; 
return rtc valid tm(rtc tm); 


linux/arch/arm/plat-samsung/devs.c 中 添加 如 下 平台 设备 信息 : 


#define S3C_PA_RTC (0x7E005000) 
#ifdef CONFIG S3C DEV RTC 
static struct resource s3c rtc resource[] = { 


Ds 


[0] = DEFINE RES MEM(S3C PA RTC, SZ 256), 
[1] = DEFINE RES IRQ(IRQ RTC ALARM), 
[2] = DEFINE RES IRQ(IRQ RTC TIC), 


struct platform device s3c device rtc = { 


js 


.name S3c64xx-rtc", 

Ad =-], 

.num resources = ARRAY SIZE(s3c rtc resource), 
Iesource = s3c rtc resource, 


#endif /*CONFIG S3C DEV RTC*/ 


修改 /drivers/rtc/rtc-s3c.c: 


static struct platform driver s3c rtc driver= { 


.probe = s3c rtc probe, 
remove — s3c rtc remove, 
.driver ={ 


简单 硬件 设备 驱动 程序 


K 动 运行 起 来 ， 还 要 定义 相应 的 平台 资 ; 


o 


首先 
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.name = "s3c64xx-rtc", 
pm X — &s3c rtc pm ops, 
.of match table — of match ptr(s3c rtc dt match), 


js 
ys 


module platform driver(s3c rtc driver); 


执行 make menuconfig 命令 对 内 核 进 行 配置 ， 在 【devices drivers] -> [Real Time 
Clock] 中 配置 RTC 支持 ， 如 图 6-8 所 示 。 


—- Real Time Clock 
[*] Set system time from RIC on startup and resume (NEW) 
irtcO0] RTC used to set the system time (NEW) 
[] ETE debug support (NEW) 
W ETC interfaces ek 


[t] — /sys/class/rtco/rtcN (sysfs)] (NEW) 

[*] /proc/driver/rtc (procfs for rtcO) (NEW) 
[*-] fdew/rtcN (character dewices) (NEW) 

[ ] ETC UIE emulation on dev interface KNEW) 
<k> — Samsung 59C series SoC RTE 


图 6-8 Real Time Clock 支持 


执行 Make zImage 生成 内 核 ， 烧 写 完 毕 系统 局 动 后 可 以 看 见 /dev 目录 下 包含 rtc0 节点 。 
4516.6 RTC 测试 实例 
本 例 演 示 如 何 设置 与 读 取 RTC 时 间 。 代 码 见 samples\6hardsimpleW6-3rtc 。 核 心 代 码 如 下 : 


int main(void) 
1 

intrtc fd; 

unsigned long data; 

int ret, 1; 

structrtc time rtc tm; 

char *rtc. dev = "/dev/rtcO"; 

time ttl, t2; 

rtc fd — open(rtc dev, O RDONLY); 

if (rte fd == -1) ( 
printf("failed to open '%s': Jos wn", rtc dev, strerror(errno)); 
exit(1); 

} else 
printf("opened '%s': fd = %d\n", rtc. dev, rtc. fd); 

printf("Get RTC Time"); 

ret = ioctl(rtc fd, RTC RD TIME, &rtc tm); 

if (ret == -1) { 
perror("rtc ioctl RTC RD TIME error"); 

j 

printf("Current RTC date/time is %d-%d-%d, %02d:%02d:%02d\n", 
rtc tm.tm mday, rtc tm.tm mon + 1, rtc tm.tm year, 


rtc tm.tm hour, rtc tm.tm min, rtc tm.tm sec); 
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上 设置 时 间 与 日 期 凡 
rtc tm.tm mday = 31; 


rtc tm.tm mon = 4; 
rtc tm.tm year = 104; 
rtc tm.tm hour = 2; 
rtc tm.tm min = 30; 
rtc tm.tm sec = 0; 
printf("Set RTC Time"); 
ret = ioctl(rtc fd, RTC _ SET TIME, &rtc tm); 
if (ret == -1) ( 
perror("rtc ioctl RTC SET TIME error"); 
j 
printf("Set Current RTC date/time to %d-%d-%d, 9602d:9602d:9602d Wn", 


rtc tm.tm mday, rtc tm.tm mon + 1, rtc tm.tm year, 


rtc tm.tm hour, rtc tm.tm min, rtc tm.tm sec); 
printf("Get RTC time"); 
// 读 RTC 时 间 
ret = ioctl(rtc fd, RTC RD TIME, &rtc tm); 
if (ret == -1) ( 
perror("rtc ioctl RTC RD TIME error"); 


j 
printf("Current RTC date/time is %d-%d-%d, %02d:%02d:%02d\n", 


rtc tm.tm mday, rtc tm.tm mon + 1, rtc_tm.tm_year, 


rtc tm.tm hour, rtc tm.tm min, rtc tm.tm sec); 
printf("RTC Tests done !'\n"); 
close(rtc fd); 
return 0; 


j 
本 例 运 行 结果 如 下 : 


[root(Q)urbetter /]# ./test 

opened '/dev/rtc0': fd = 3 

Get RTC Time 

Current RTC date/time is 9-1-100, 18:02:55 

Set RTC Time 

Set Current RTC date/time to 31-5-104, 02:30:00 
Get RTC time 

Current RTC date/time is 31-5-104, 02:30:00 
RTC Tests done !! 


6.8 LED 类 设 


Linux 内 核 中 定义 了 LED 类 设备 专门 处 理 各 种 外 设 的 LED AJ» LED 类 设备 定义 如 下 : 


struct led classdev { 
const char *name; 
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enum led brightness brightness; 
enumled brightness max brightness; 
int flags; 
/设置 led 亮度 
void (*brightness set)(struct led classdev *led cdev,enum led brightness brightness); 
/阻塞 式 设置 设置 led 亮度 ， 设 置 完毕 才 返 回 
int (*brightness_set blocking)(struct led classdev *led cdev,enum led brightness brightness); 
enum led brightness (*brightness get)(struct led classdev *led cdev);// 获 取 led 亮度 
int (*blink set)(struct led classdev *led cdev,unsigned long *delay on, 
unsigned long *delay of;/ 闪 烁 
struct device *dev; 


const struct attribute group — **groups; 
B 
LED 类 设备 的 注册 与 注销 方法 : 


intled classdev register(struct device *parent, struct led classdev *led cdev); 
voidled classdev unregister(struct led classdev *led cdev); 


j 


O 


要 使 用 LED 类 设备 ， 首 先 要 配置 内 核 LED 支持 ， 在 内 核 Device Drivers 配置 项 下 选中 
LED Support 与 LED Class Support. 

1516.7 LED classdev 实例 

本 例 演 示 LED 类 设备 的 使 用 方法 。 代 码 见 \samples\6hardsimple\6-7ledclass。 核 心 代 
f ap F: 


static struct led classdev led dev; 
static void led classdev setl(structled classdev *led cdev, enum led brightness value) 


1 
led cdev-»brightness = value; 
if(value) 
1 
LED SI H(0); 
printk(" raw readl((S3C64XX GPMDAT)=0x%x\n", raw readl(S3C64XX GPMDAT)); 
} 
else 
{ 
LED SI L(0); 
printk(" raw readl(S3C64XX GPMDAT)=0x%x\n", raw readl(S3C64XX GPMDAT)); 
} 
} 
static enum led brightness led classdev getl(structled classdev * led cdev) 
1 
return led cdev-»brightness; 
} 
static int plate test probe(struct platform device *pdev) 
1 
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int ret; 
led dev.brightness set = led classdev setl; 


led dev.brightness get = led classdev getl; 


led dev.name = "fgjled"; 
ret = led classdev register(&pdev-^dev, &led dev); 
if (ret < 0) { 

printk("led classdev register failed%d\n",ret); 


return ret; 

} 

return 0; 
} 
static int plate test remove(struct platform device *pdev) 
1 

led classdev unregister(&led dev); 

return 0; 
} 


static struct platform driver plate test driver = { 
.probe = plate test probe, 
remove = plate test remove, 
.driver = ( 
.name = "Jeddevtest", 
.owner — THIS MODULE, 


H ^5 

h 

static int — init plateform test init (void) 

{ 
platform device register(&plate test device); 
platform driver register(&plate test driver); 
return 0; 

j 

static void — exit plateform test exit (void) 

{ 
platform driver unregister(&plate test driver); 
platform device unregister(&plate test device); 

j 


module init (plateform test init); 
module exit (plateform test exit); 


本 例 运 行 结果 如 下 : 


[root@urbetter drivers |£ insmod demo.ko 
[root(Q)urbetter drivers |? cd /sys/class/leds 
[root@urbetter leds]# ls 

fgjlled mmce0:: 

[root@urbetter leds]# cd fgjled/ 
[root@urbetter fgjled]# ls 

brightness max brightness subsystem 
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device power uevent 
[root(Qurbetter fgjled] echo 0 »brightness / KXT 

. raw readl(S3C64XX GPMDAT)-0x10 
[root(Qurbetter fgjled]£ echo 255 »brightness — //4& 4] 
. raw readl(S3C64XX  GPMDAT)-0x11 
[root(a)urbetter fgjled]# cat brightness 

23/3 

[root(Q)urbetter fgjled]# 


156 


B Tn 


为 提高 代码 的 扩 
高 了 代码 的 可 重用 性 。I2C 接 


供 了 很 好 的 支持 。 


本 章 重 


71 I2C 接口 原理 


IC (Inter-Integrated Circuit) 总 线 是 一 种 | 


接 微 控制 器 及 其 外 
器 件 都 有 一 个 只 


从 机 。 


DC 总 线 最 主要 的 优点 是 
间 非 常 小 ， SAN E 


的 空 


达 25ft (7.62m)，3 


2o 


DC 总 线 的 另 一 ee 
为 主 总 线 。I2C 总 


ra 


DC WEE T 


展 性 与 灵活 性 ，Linux 对 所 有 设备 驱 
AUN GR A 
点 介绍 DC 接口 原理 与 Linux 内 


中 最 基本 、 


FA DC 设备 驱动 程序 架 


简单 性 和 有 效 性 。 


x] 


Philips Z 


E ~EIZ E , 因 


由 于 接口 旨 


线 上 在 任 


当 有 多 于 一 个 主机 尝试 控制 总 线 时 ， 


= 


! 裁 原则 是 当 多 个 主 器 件 同 时 想 占 


可 时 刻 


只 能 


制 


, 


retra 


发 送 低 电 平 ， 则 发 送 电 平 与 此 
竞争 的 仲裁 是 在 两 个 
则 进入 数据 位 的 比较 ， 从 而 


EX 


一 个 控制 总 线 
个 主 器 件 发 送 高 


WRH 


BFEARN RT EAÉE A ARA H 


ERITH. H^ 


H, 


GÆ Í 


也 址 位 的 比较 ， 如 果 


HR 
由 于 是 不 


EA] UH 
ix H 


M HARE 


HEI 10ms。 


小 取决 于 区 片 内 页 寄 


所 示 。 


AT24Cxx 系 列 EEPROM 的 8 位 I2C 地 址 的 计算 方法 是 
固定 的 1010， 后 面 三 位 ! 


前 四 位 为 


anb 
一 | 


不 会 造成 信 ， 
ELI AT24Cxx EEPROM 为 例 说 明 I2C 设备 原 弄 
Microchip 公司 出 品 的 支持 DC 总 线 数据 传送 协议 的 串 
ÍT E2PROM 一 般 具 有 两 种 写 入 方式 ， 
页 写 入 方式 。 人 允许 在 一 个 写 周 期 内 同时 对 1 个 字 节 到 
AT24C02 具有 16B 数据 的 页 面 写 能 

AT24C02 包含 8 MEH, SCL 为 串 行 时 钟 ， 
串 行 数据 /地 址 ，A0、Al、A2 为 器 伯 
写 保护 脚 ， 电 平 为 高 则 芯片 只 读 ，Vcec 为 电源 。 如 图 


EA. 


存 器 的 大 小 。 


MRT EFA 


裁 的 可 靠 性 。 


地 址 输入 端 ; 


A2. Al 


JH 


动 都 进行 了 抽象 ， 这 种 抽象 大 大 提 
最 常用 的 串 行 接口 ，Linux 对 


提 


8 构 。 


发 的 两 线 式 串 行 总 线 ， 用 于 连 
围 设备 。 在 物理 结构 上 ，I2C 总 线 由 数据 线 SDA 和 时 钟 SCL 构成 ， 每 个 
的 地 址 识别 。 发 送 数据 到 总 线 的 器 件 叫 作 发 送 器 ， 
叫 作 接收 器 。 初 始 化 发 送 产 生 时 钟 信 号 和 终止 发 送 的 器 件 叫 作 主机 ， 


从 总 线 接收 数据 的 器 件 
被 主机 寻 址 的 器 件 叫 作 


此 DC i£ 
E 间 和 芯片 管 脚 的 数量 ， 降 低 了 互联 成 本 。 总 线 的 长 度 可 
能 够 以 10kbit/s 的 最 大 传输 速率 支持 40 个 组 件 。 
够 进行 发 送 和 接收 的 设备 者 
一 个 主机 ， 主 机 能 够 控制 信号 的 传输 和 时 钟 
通过 仲裁 上 只 使 能 
用 总 线 时 ， 
时 SDA 总 线 


可 以 成 
频率 。 


并 使 报 文 不 被 破坏 。 

外 平 ， 而 另 一 个 主 器 件 
出 级 。 总 线 
主 器 件 寻 址 同一 个 从 器 件 ， 
I2C 总 线 上 的 信息 


进行 促 


。AT24Cxx 系列 EEPROM 是 


美 


行 E2PROM， 可 用 电 擦 除 ， 
一 种 是 字 节 写 入 方式 ， 


自动 控 
男 一 种 


一 页 的 若干 字 节 的 编程 写 入 ， 


页 的 大 


SDA 为 
WP 为 
7-1 


、A0 管 脚 决 


图 7-1 AT24Cxx 系列 EEPROM 管 脚 


Linux 驱动 程序 开发 实例 第 2 版 


定 ， 最 后 一 位 代表 读 写 ， 为 1 表示 读 ， 为 0 表示 写 。 如 图 7-2 所 示 。 


ole ll ella ll 


MSB LSB 


图 7-2 AT24Cxx 的 I2C 地 址 


下 面具 体 说 明 AT24Cxx 的 DC 总 线 时 序 。 

(D 开始 条 件 (START) 

在 SCL 线 处 于 高 电 平时 ，SDA 线 从 高 电 平 向 低 电 平 切换 ， 表 示 一 个 开始 信号 。 
(2) 停止 条 件 (STOP) 
当 SCL 线 处 于 高 电 平时 ，SDA 线 由 低 电 平 向 高 电 平 切换 ， 表 示 一 个 停止 条 件 。 
开始 和 停止 条 件 如 图 7-3 所 示 。 


图 7-3 开始 和 停止 条 件 


(3) 数据 传输 

SDA 线 上 的 数据 必须 在 时 钟 的 高 电 平 周期 保持 稳定 ， 数 据 线 的 高 或 低 电 平 状态 只 有 在 
SCL 线 的 时 钟 信号 是 低 电 平时 才能 改变 ， 否 则 将 代表 开始 和 停止 条 件 出 现 。 总 线 在 起 始 条 件 
后 被 认为 处 于 忙 的 状态 ， 在 停止 条 件 的 某 段 时 间 后 总 线 被 认为 再 次 处 于 空闲 状态 。 

发 送 到 SDA 线 上 的 每 个 字 节 必须 为 8bit。 每 次 传输 可 以 发 送 的 字 节 数量 不 受 限 制 。 每 
个 字 节 后 必须 跟 一 个 响应 位 (ACK)。 首 先 传输 的 是 数据 的 最 高 位 MSB。 在 响应 时 钟 脉冲 期 
闻 ， 接 收 吉 必须 将 SDA 线 拉 低 ， 使 它 在 这 个 时 钟 脉冲 的 高 电 平 期 间 保持 稳定 的 低 电 平 。 
&| 7-4 是 DC 数据 传送 时 序 图 。 


T 


DATA OUT 


START ACKNOWLEDGE 


图 7-4 IC 数据 传送 时 序 
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(4) 单字 节 写 
单字 节 写 的 流程 是 开始 条 件 后 发 送 器 件 写 地 址 ， 然 后 发 送 器 件 内 部 地 址 ， 最 后 发 送 数 
据 ， 每 发 送 一 个 字 节 都 要 有 应 答 。 图 7-5 是 DC 单字 节 写 时 序 图 。 


S WwW 

T R S 

A I T 

R DEVICE T (0) 

T ADDRESS E WORD ADDRESS DATA P 
M LRA M L A A 
S S/C S S cC C 
B BWK B BK K 


图 7-5 IC 单字 节 写 时 序 


(5) 单字 节 读 
单字 节 读 的 流程 是 开始 条 件 后 发 送 器 件 写 地 址 ， 然 后 发 送 器 件 内 部 地 址 ， 结 束 后 再 发 

个 开始 条 件 ， 接 着 发 送 器 件 读 地 址 ， 最 后 接收 数据 ， 每 发 送 一 个 字 节 都 要 有 应 答 。 图 7-6 是 
I2C 单字 节 读 时 序 图 。 
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图 7-6 I2C 单字 节 读 时 序 


7.2 Linux 的 I2C 驱动 程序 架构 


典型 的 PC 接口 的 硬件 架构 如 图 7-7 所 示 。 


E 
I2C 总 线 Registers 


/ I2C 设 备 
Memory 


处 理 器 
(I2C 主 机 ) 


Registers 


/ I2C 设 备 
Memory 


图 7-7 I2C 接口 硬件 架构 
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为 了 提高 代码 的 扩展 性 与 灵活 性 ，Linux 对 所 有 设备 驱动 都 进行 了 抽象 ， 这 种 抽象 大 大 
提高 了 代码 的 可 重用 性 。 针 对 DC 总 线 上 相关 的 元 素 ， 内 核 抽象 出 了 i2c_adapter、 
i2c algorithm, i2c client 和 i2c driver 等 总 线 结构 ， 如 图 7-8 所 示 。 


个 性 化 驱动 
混合 型 驱动 


i2c algorithm 


图 7-8 Linux DC 子 系统 架构 


7.2.1 IC 适配器 


DC 总 线 适 配器 相当 于 一 个 DC 设备 挂 载 点 ， 处 理 器 上 的 DC 控制 器 就 是 一 个 典型 的 


总 线 适 本 


zNL«E 


器 。 也 有 部 分 处 理 器 平台 上 采用 GPIO 模拟 DC 时 序 ， 可 以 看 作 是 虚拟 的 DC 


适配器 。I2C 适配器 用 ic adapter 结构 描述 : 


struct i2c adapter { 


js 


struct module *owner; 

unsigned int class; 

const struct i2c algorithm *algo; /* MW |n] $33; */ 
void *algo data; 

struct rt mutex bus lock; 

int timeout;，/#* 超 时 时 间 ， 单 位 同 jiffies*/ 

int retries; / 重 试 次 数 

struct device dev;* 适 配器 设备 */ 

int nr; /总 线 号 

char name[48]; 


struct completion dev released; 

struct mutex userspace clients lock; 

struct list head userspace clients; 

struct i2c bus recovery info *bus recovery info; 

const struct i2c adapter quirks *quirks;/I2C 适配器 的 缺陷 或 限制 


向 内 核 添 加 一 个 i2c_adapter 的 函数 如 下 : 
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inti2c add adapter(struct i2c adapter *adap); /使 用 动态 DC 总 线 号 
inti2c add numbered adapter(struct i2c adapter *adap) /使 用 指定 I2C 总 线 号 


上 面 两 个 函数 会 调用 i2c register adapter 注册 2C 适配器 ， 并 在 /dev 目录 产生 一 个 主 设 
备 号 为 PC MAJOR 的 DC 设备 节点 。i2c_ del adapter 函数 从 内 核 删 除 一 个 i2c adapter: 


inti2c del adapter(struct i2c adapter *adap); 


处 理 器 中 的 IC 控制 器 均 是 DC 适配器 。 另 外 ， 适 配器 也 可 以 采用 GPIO 端口 模拟 方式 
实现 ， 具 体 参 见 内 核 中 的 i2c-algo-bit.c。 


722 IC 算法 

DC 算法 G2c algorithm). 表示 一 套 通信 方法 。 一 个 PC 适配器 (i2c_adapter) 需 要 一 个 通信 
规则 (i2c algorithm) 来 控制 适配器 产生 特定 的 时 序 。i2c_adapter 结构 中 包含 一 个 i2c algorithm 
成 员 。i2c algorithm 结构 如 下 : 


struct i2c algorithm { 
/DPC 总 线 传输 函数 
int (*master xfer)(struct i2c_adapter *adap, struct i2c_msg *msgs,int num); 
/SMBUS 总 线 传输 函数 
int (*smbus xfer) (struct i2c adapter *adap, u16 addrunsigned short flags, char read write, 
u8 command, int size, union i2c smbus data *data); 
u32 (*functionality) (struct i2c adapter *);/* 检 测 adapter 支持 的 功能 */ 
#if IS ENABLED(CONFIG IC SLAVE) 
int (*reg slave)(struct i2c client *client); 
int (Funreg slave)(struct i2c client *client); 
#endif 
h 


723 IC 从 设备 

HERE I2C 总 线 上 的 不 能 控制 总 线 的 设备 称 为 DC 从 设备 ， 通 常 是 一 个 外 围 芯片 。 
i2c client. 结构 表示 连接 到 DC 总 线 上 的 从 设备 。 每 个 从 设备 具有 一 个 或 者 多 个 DC 地 
址 。 处 理 器 根据 DC 地 址 访问 I2C 从 设备 ， 而 DPC 从 设备 则 根据 地 址 决定 是 否 对 I2C d 
令 进 行 响应 。 


E 


struct i2c. client { 
//I.C CLIENT TEN 表示 10 位 地 址 ;， I2C. CLIENT PEC 表示 使 用 SMBUS 包 错 误 检 查 
unsigned short flags; 
unsigned short addr; /7 位 芯片 地 址 
char name[I2C NAME SIZE]; 
struct i2c adapter *adapter; /# 关 联 的 adapter*/ 
struct device dev; Pri EN 
int irq; *rB lr] 
struct list head detected; 
#fIS ENABLED(CONFIG I2C SLAVE) 
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j2c slave cb tslave cb; 
#endif 
H 
724 IC 从 设备 驱动 
i2c driver 结构 代表 一 个 DC 从 设备 的 驱 


和 从 模式 回 


它 往往 与 其 他 驱动 子 系统 组 合成 一 个 混合 


struct i2c driver ( 


unsigned int class; 


型 可 


REX 


5J] o 


int (attach adapter)(struct i2c adapter *) 


* 


ERER RER O 


/ 


K 动 。 


s 


n à 


DC 从 设备 驱动 主要 


负责 与 2C 核心 交互 ， 


.. deprecated;/ 绑 定 适配器 (即将 作废 ) 


int (*probe)(struct i2c client *, const struct 2c device id *);// 探 测 


int (*remove)(struct i2c client *); 


void (*shutdown)(struct i2c client *);//f 1E 
void (*alert)(struct i2c client *, unsigned int data);// 警 告 回调 


， 例 如 SMBus 警告 协议 


int (*command)(struct i2c client *client, unsigned int cmd, void *arg);// 命 令 处 理 ， 类 似 ioctl 


struct device driver driver; 
const struct i2c device id *id table; 


PHASE RS Ee 87 


int (*detect)(struct i2c client *, struct i2c. board info *); 


const unsigned short *address list; 
struct list head client; 


5 
添加 一 个 ic driver 的 函数 如 下 : 


inti2c add driver(struct i2c driver *driver); 


删除 一 个 i2c_driver 的 函数 如 下 : 


inti2c del driver(struct i2c. driver *driver); 


i2c driver 的 快捷 注册 与 注销 接口 如 下 : 


#define module i2c driver( 12c driver) V 


module driver( i2c driver, i2c add driver, V 


i2c del driver) 


例如 pcf8583 RTC 芯片 驱动 入 


static struct i2c driver pcf8583 driver = { 
.driver = ( 
.name = "pcf8583", 


j i 
.probe = pcf8583 probe, 
Jd table = pcf8583 1d, 
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/DC 设备 驱动 模块 入 口 
module i2c driver(pcf8583 driver); 


72.5 IC 从 设备 驱动 开发 


Linux I2C 从 设备 驱动 有 两 种 开发 方法 : 

(1) 个 性 化 的 从 设备 驱动 。 在 内 核 中 通过 调用 i2c_add_driver 注册 2C 从 设备 驱动 ， 同 
时 在 i2c driver 结构 的 probe 函数 中 注册 一 个 功能 类 驱动 ， 以 实现 具体 的 功能 。I2C 从 设备 
驱动 仅 实现 通信 功能 ， 具 体 功能 交 给 功能 类 驱动。 

(2) 使 用 内 核 通用 的 I2C 从 设备 接口 ， 通 过 应 用 层 对 设备 进行 访问 。 这 相当 于 在 内 核 中 
为 应 用 层 与 设备 搭建 了 一 条 高 速 通 道 。 应 用 层 通 过 /dev/i2c-* 节 点 可 以 访问 所 有 挂 载 在 总 线 上 的 
PC 设备 ， 只 要 该 设备 没有 使 用 方法 1 注册 驱动 。 

后 面 将 详细 介绍 这 两 种 方法 。 


73 ”JI2C 控制 器 驱动 


7.344. S3C2410X 的 DC 控制 器 


S3C2410X 的 DC 控制 器 是 通过 DCSCL 和 DCSDA 引 脚 和 DC 芯片 进行 通信 的 。I2C 
总 线 的 开始 和 结束 信号 是 由 S3C2410X 的 DC 控制 器 完成 的 。S3C2410X 中 采用 统一 编 址 方 
式 ，I2C 控制 器 与 存储 空间 统一 编 址 。 图 7-9 是 S3C2410X 的 DC 控制 器 原理 图 。 


Address Register 
Shift Register 


Shift Register 
(I2CDS) 


I2C-Bus Control logic 


I2CCON | I2CSTAT 


SCL 


PCLK 4—bit Prescaler 


— SDA 


Data Bus 


图 7-9 S3C2410X 的 2C 控制 器 原理 


S3C2410X 中 包含 DC 总 线 控制 寄存 器 、I2C 状态 寄存 器 、I2C 地 址 寄存 器 和 DC 数据 移 
位 寄存 器 等 寄存 器 。I2C 总 线 控制 寄存 器 DCCON 主要 用 于 设置 发 送 时 钟 频率 、I2C 总 线 应 
答 、 中 断 开 关 等 。I2C 控制 与 状态 寄存 器 DCSTAT 用 来 选择 传输 模式 〈 主 发 送 模式 、 主 接收 
模式 、 从 发 送 模式 、 从 接收 模式 ) 和 跟踪 总 线 空闲 状态 、 总 线 仲裁 状态 、 作 为 从 设备 时 的 状 
态 等 信息 。I2C 地 址 寄存 器 DCADD 用 来 存放 从 设备 的 地 址 。I2C 数据 移 位 寄存 器 DCDS 用 
来 存放 输入 输出 的 数据 。 表 7-1 和 表 7-2 2) 9023 I2CCON 寄存 器 和 I2CSTAT 寄存 器 的 描述 。 
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表 7-1 DCCON 寡 存 器 
I2CON Bi 描述 初始 值 
ACK 使 能 位 

Acknowledge generation [7 0 二 禁用 ，1 二 使 能 0 

Tx clock source IIC-bus 时 钟 选择 0 

selection [6 0 —- IICCLK = fPCLK /16 
] = IICCLK = fPCLK /512 
Tx/Rx 中 断 使 能 位 

Tx/Rx Interrupt [5 0 二 禁用 ，1 二 使 能 0 

Interrupt pending flag [4 未 处 理 中 断 标志 0 

Transmit clock value [3:0] IIC-Bus 传输 时 钟 分 频 因子 

表 7-2 I2CSTAT 寄存 器 
I2CSTAT Bit 描述 初始 值 

DC 总 线 模式 : 

Mode selection [7:6] 00: 从 接收 01: 从 发 送 00 
10: 主 接收 11: 主 发 送 

Busy signal status /START STOP condition 5 IIC-Bus 忙 状态 0 

IC-Bus 数据 输出 使 能 
Serial t 4 0 
EN 二 禁止 Rx/Tx,1 — fife IIC-Bus 

IIC-bus 仲裁 状态 

Arbitration status flag 3 0 三 总 线 仲裁 成 功 0 
1 三 总 线 仲裁 失败 

Address-as-slave status flag 2 从 设备 地 址 匹配 状态 0 
0 地 址 状态 

Address zero status flag 1 0 三 检测 到 START/STOP 条 件 0 
1 三 从 地 址 为 00000000b 

Last-received bit status flag 0 最 后 一 个 接收 到 的 位 的 状态 0 


7.32. S3C2A10X 的 DC 控制 器 驱动 


DC 总 线 控制 器 即 DPC adapter, I2C 总 线 控制 器 驱动 需要 提供 相应 的 PC 算法 ， 以 实现 


解 总 线 类 驱动 程序 的 开发 方法 。S3C2410X 的 DC 总 


数据 通信 。 本 节 以 i2c-s3c2410.c HA, i 
线 探测 函数 如 下 : 


static struct platform driver s3c24xx 12c driver = ( 


.probe 

remove 
Jd table 
.driver ={ 


.name = "s3c-i2c", 
.pm 


.of match table — of match 


= s3c24xx 12c probe, 
= s3c24xx 12c remove, 
= s3c24xx driver ids, 


= S3C24XX DEV PM OPS, 


ptr(s3c24xx 12c match), 


1 
js 


static int s3c24xx i2c probe(struct platform device *pdev) 


1 


struct s3c24xx 12c *i2c; 


struct s3c2410 platform i2c *pdata = NULL; 
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struct resource *res; 
int ret; 
if (Ipdev->dev.of node) ( 
pdata = dev get platdata(&pdev->dev);/ 获 取 私 有 数 ] 
if (!pdata) { 
dev_ err(&pdev->dev, "no platform data\n"); 
return -EINVAL; 


mi 


} 
// 分 配 s3c24xx i2c 
i2c = deym kzalloc(&pdev->dev, sizeof(struct s3c24xx i2c), GFP KERNEL); 
if (li2c) 
return -ENOMEM; 
i2c-^pdata = devm kzalloc(&pdev-»^dev, sizeof(*pdata), GFP KERNEL); 
if (!i2c-^pdata) 
return -ENOMEM; 
12c-^quirks = s3c24xx get device quirks(pdev); 
I2c-»sysreg = ERR. PTR(-ENOENT); 
if (pdata) 
memcpy(i2c->pdata, pdata, sizeof(*pdata)); 
else 
s3c24xx 12c parse dt(pdev-^dev.of node, 12c); 
/填充 适配器 信息 
strlcpy(i2c->adap.name, "s3c2410-i2c", sizeof(i2c->adap.name)); 
i2c->adap.owner = THIS MODULE; 
i2c->adap.algo = &s3c24xx_i2c algorithm;// 设 置 DC 算法 
i2c->adap.retries = 2;// 重 试 次 数 
i2c->adap.class = I2C_CLASS DEPRECATED; 
i2c->tx_setup = 50; 
/初始 化 等 待 队列 
init waitqueue head(&i2c-—wait); 
/获取 时 钟 
12c-»dev = &pdev-»dev; 
i2c->clk = devm clk get(&pdev-^dev, "i2c"); 
if (IS ERR(i2c-»clk)) { 
dev err(&pdev-»dev, "cannot get clock"); 
return -ENOENT; 


} 
dev dbg(&pdev->dev "clock source %p\n", 12c->clk); 
/获取 内 存 资源 
res = platform get resource(pdev, IORESOURCE MEM, 0); 
i2c->regs = deym ioremap resource(&pdev-»dev, res); 
if (IS ERR(i2c->regs)) 
return PTR ERR(i2c-7regs); 
dev dbg(&pdev-»dev, "registers %p (Vop)n", 
12c->regs, res); 


165 


Linux 驱动 程序 开发 实例 第 2 版 


166 


族 填 充 适 配器 信息 */ 

12c->adap.algo_data = i2c; 

12c->adap.dev.parent = &pdev->dev; 

i2c->pctrl = devm pinctrl get select default(i2c->dev); 

x) 5 GPIO*/ 

if (12c-^pdata-^cfg gpio) { 
i2c-^pdata-^cfg gpio(to platform device(12c-^dev)); 

} else if (IS ERR(i2c-^pctrl) && s3c24xx i2c parse dt gpio(12c)) { 
return -EINVAL; 


} 
clk prepare_enable(i2c->cllo;/ 使 能 时 钟 
ret = s3c24xx i2c init(i2c); /* 初 始 化 I2C 控制 器 */ 
clk disable(i2c->clk); 
if (ret != 0) 1 
dev err(&pdev-»dev, "I2C controller init failed"); 


return ret; 


j 
/获取 中 断 
if (!(i2c->quirks & QUIRK POLL)) { 
i2c->irq = ret = platform get irq(pdev, 0); 
if (ret <= 0) { 
dev err(&pdev-»dev, "cannot find IRQWn"); 
clk unprepare(12c-^clk); 


return ret; 
} 
/申请 中 断 
ret = deym request irq(&pdev->dev, i2c->irq, s3c24xx i2c irq, 0,dev name(&pdev->dev), i2c); 
if (ret != 0) ( 
dev err(&pdev-»dev, "cannot claim IRQ 96d", i2c->irq); 
clk unprepare(12c-^clk); 
return ret; 
} 
} 


// 申 请 接收 CPU 频率 调节 通知 
ret = s3c24xx i2c register cpufreq(i2c); 
if (ret < 0) 1 
dev err(&pdev-»dev, "failed to register cpufreq notifier n"); 


clk unprepare(12c-^clk); 
return ret; 
} 
i2c->adap.nr = i2c->pdata->bus_num;// 关 联 的 总 线 号 
12c->adap.dev.of node = pdev->dev.of node; 
platform set drvdata(pdev, 12c); 
pm runtime enable(&pdev-»dev); 
/注册 PC 适配器 
ret—i2c add numbered adapter(&i2c->adap); 
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if (ret < 0) 1 
dev err(&pdev-»dev, "failed to add bus to i2c core"); 
pm runtime disable(&pdev-^dev); 
s3c24xx 12c deregister cpufreq(i2c); 
clk unprepare(12c-^clk); 
return ret; 
} 
dev_info(&pdev->dev, "%s: S3C I2C adaptern", dev name(&i2c->adap.dev)); 
return 0; 


} 
devm request irq 函数 会 调用 request threaded irq 函数 注册 中 断 : 


int request threaded irq(unsigned int irq, irq_handler t handler, 
irq handler tthread fn, unsigned long irgflags,const char *devname, void *dev 1d) 
= thread fn 不 为 NULL， 内 核 会 创建 线程 来 处 理 中 断后 半 部 ， 中 断 处 理 函 数 handler 返回 
IRQ WAKE THREAD 以 唤醒 线程 处 理 。 当 thread fn 为 NULL， 不 创建 线程 处 理 中 断 。 
在 i2c algorithm 结构 中 的 master xfer 成 员 是 DIC 核心 通信 函数 接口 : 


static const struct i2c algorithm s3c24xx 12c algorithm = { 
.master xfer = s3c24xx i2c xfer, 
functionality = s3c24xx i2c func, 
h 
static int s3c24xx i2c xfer(struct i2c adapter *adap,struct i2c msg *msgs, int num) 
1 
struct s3c24xx i2c *i2c = (struct s3c24xx 12c *)adap->algo data; 
int retry; 
int ret; 
ret = clk enable(i2c->clk); 
if (ret) 
return ret; 
for (retry = 0; retry < adap-retries; Tetry++) { 
ret = s3c24xx i2c doxfer(i2c, msgs, num); 
if (ret != -EAGAIN) { 
clk disable(12c-^clk); 
return ret; 
j 
dev dbg(i2c-^dev, "Retrying transmission (od) Wn", retry); 
udelay(100); 
j 
clk disable(12c-^clk); 
return -EREMOTEIO; 
j 


s3c24xx i2c doxfer 函数 负责 启动 DC 数据 传输 ， 并 等 待 结束 。 


static int s3c24xx i2c doxfer(struct s3c24xx 12c *i2c,struct i2c msg *msgs, int num) 
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1 
unsigned long timeout; 
int ret; 
if (i12c-^suspended) 
return -EIO; 
ret = s3c24xx i2c set master(i2c); 
if (ret != 0) ( 
dev err(i2c-^dev, "cannot get bus (error %d)\n", ret); 
ret = -EAGAIN; 
goto out; 
} 
i2c->msg = msgs; /把 消息 地 址 传递 给 s3c24xx_i2c 结构 
i2c->msg_ num = num; 
i2c-^msg ptr = 0; 
12c-2msg idx = 0; 
i2c-^state = STATE START; /状态 为 DC 起 始 
S3c24xx i2c enable irq(i2c); /使 能 中 断 
s3c24xx i2c message start(i2c, msgs); ”// 启 动 传输 
if (i2c->quirks & QUIRK POLL) 1 
ret = i2c-^msg idx; 
if (ret != num) 
dev dbg(i2c-^dev, "incomplete xfer (Vod) Wn", ret); 
goto out; 
} 
timeout = wait event timeout(i2c->wait, i2c->msg num == 0, HZ * 5);// 等 待 传输 结束 时 间 
ret = i2c-^msg idx; 
/超时 判断 
if (timeout == 0) 
dev dbg(i2c--dev, "timeout in"); 
else if (ret != num) 
dev dbg(i2c-^dev, "incomplete xfer (Vod) Wn", ret); 
/# 如 果 有 QUIRK HDMIPHY 标记 ,总 线 已 经 禁止 ， 直 接 退 出 */ 
if (12c->quirks & QUIRK HDMIPHY) 
goto out; 
s3c24xx i2c wait idle(12c); 
s3c24xx i2c disable bus(i2c); 
out: 
i2c-^state = STATE IDLE; 
return ret; 
} 


s3c24xx i2c message start 函数 用 来 启动 DC 传输 : 


static void s3c24xx 12c message start(struct s3c24xx 12c *i2c,struct i2c msg *msg) 


1 
unsigned int addr = (msg->addr & 0x7f) << 1; 
unsigned long stat; 
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unsigned long iiccon; 

stat — 0; 

stat = S3C2410 IICSTAT TXRXEN; 

if (msg->flags & DPC M RD) /根据 读 写 来 确定 发 送 地 址 
stat = S3C2410 IICSTAT MASTER RX; 
addr |= 1; 

} else 
stat = S3C2410 IICSTAT MASTER TX; 

if (msg->flags & I2C M REV DIR ADDR) 
addr ^= 1; 

s3c24xx i2c_enable_ack(i2c); 

liccon = readl(i2c-^regs + S3C2410 IICCON); 

writel(stat, i2c->regs + S3C2410 IICSTAT); 


dev dbg(i2c->dev "START: %08lx to IICSTAT, %02x to DS\n", stat, addr); 


writeb(addr, i2c->regs + S3C2410 IICDS); 
/这 里 延迟 为 确保 数据 在 传输 开始 前 到 达 总 线 上 
ndelay(i2c-^tx setup); 


dev dbg(i2c->dev "iiccon, 99081x n", iiccon); 
writel(iiccon, i2c->regs + S3C2410 IICCON); 
stat |= S3C2410 IICSTAT START; 
writel(stat, i2c->regs + S3C2410 IICSTAT); /开始 传输 
if (i2c->quirks & QUIRK POLL) 1 
while ((i2c->msg num != 0) && is ack(i2c)) 1 
12c s3c irq nextbyte(12c, stat); 
stat = readl(12c-^regs + $33C2410 IICSTAT); 
if (stat & S3C2410 IICSTAT ARBITR) 
dev err(i2c-^dev, "deal with arbitration loss"); 


传送 或 接收 成 功 后 会 收 到 中 断 ， 中 断 处 理 函 数 为 S3c24xx_i2c_irq: 


static irqreturn t s3c24xx i2c irq(int irqno, void *dev 1d) 


1 


struct s3c24xx i2c *i2c = dev id; 

unsigned long status; 

unsigned long tmp; 

status = readl(12c-^regs + S3C2410 IICSTAT); 

if (status & S3C2410 IICSTAT ARBITR) ( 
PREGA R 


dev err(i2c-^dev, "deal with arbitration loss"); 


j 

if (i2c->state == STATE IDLE) { 
dev dbg(i2c-^dev, "IRQ: error i2c-^state == IDLEWM"); 
tmp = readl(i2c-^regs + S33C2410 IICCON); 
tmp &- —$3C2410 IICCON IRQPEND; 
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writel(tmp, i2c->regs + S3C2410 IICCON); 
goto out; 


j 

i2c s3c irq nextbyte(i2c, status);// 下 一 字 节 
out: 

retum IRQ HANDLED; 


ijs s3c irq nextbyte 函数 用 来 发 送 或 接收 下 一 个 字 节 : 


static int i2c s3c irq nextbyte(struct s3c24xx i2c *i2c, unsigned long iicstat) 
1 
unsigned long tmp; 
unsigned char byte; 
int ret — 0; 
switch (i2c->state) {// 根 据 传输 所 处 的 状态 做 出 进一步 的 动作 
case STATE IDLE: 
dev_err(i2c->dev, "%s: called in STATE IDLEW", func ); 
goto out; 
case STATE STOP: 
dev err(i2c->dev, "%s: called in STATE STOPW", func ); 
s3c24xx 12c disable irq(i2c); 
goto out ack; 
case STATE START: 
if (iicstat & S3C2410 IICSTAT LASTBIT && 
!(12c-2msg-^flags & I2C M IGNORE NAK)) { 
[* RFI] ack*/ 
dev _dbg(i2c->dev, "ack was not received\n"); 
s3c24xx _i2c_stop(i2c, -ENXIO); 
goto out ack; 


} 
if (i2c->msg->flags & IDDC M RD) 
i2c->state = STATE READ; 
else 
i2c->state = STATE WRITE; 
if (is lastmsg(i2c) && i2c->msg->len == 0) ( 
s3c24xx 12c stop(12c, 0); 
goto out ack; 
} 
if (i12c->state == STATE READ) 
goto prepare read; 
case STATE WRITE: 
if (!(i2c-7msg-»flags & I2C M IGNORE NAK)) { 
if (iicstat & S3C2410 IICSTAT LASTBIT) { 
dev dbg(i2c->dev "WRITE: No Ack\n"); 
/发 送 停止 位 
s3c24xx i2c stop(i2c, -ECONNREFUSED); 
goto out ack; 
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j 


retry write: 
if (lis msgend(12c)) { 
byte = i2c->msg->bufli2c->msg ptr--]; 


writeb(byte, i2c->regs + S3C2410 IICDS);/ 写 一 字 节 到 总 线 


ndelay(i2c-^tx setup); 
} else if (lis lastmsg(i2c)) { 

/*we need to go to the next i2c message*/ 

dev dbg(i2c-^dev, "WRITE: Next Message"); 

i2c-2msg ptr = 0; 

i2c->msg_idx++,; 

12c->msg++; 

放 检 查 发 送 是 否 成 功 */ 

if (i2c->msg->flags & I2C M NOSTART) ( 
if (i2c-2msg-^flags & I2C M RD) ( 

s3c24xx 12c stop(12c, -EINVAL); 

} 
goto retry_write; 

) else { 
[ARIRIH start*/ 
s3c24xx i2c message start(12c, i2c-^msg); 
i2c-»state = STATE START; 


} 
} else ( 
/发 送 停止 位 
s3c24xx i2c_stop(i2c, 0); 
} 
break; 
case STATE READ: 
Jp 
byte = readb(i2c-^regs + S3C2410 IICDS); 
i2c-2msg-»buf[i2c-^msg ptr] = byte; 
POE BORA BEN 


if (i2c->msg->flags & IDCC M RECV LEN && i2c->msg->len == 1) 


i2c->msg->len += byte; 
prepare_read: 
if (is_msglast(i2c)) { 
PEPPER E 
if(is lastmsg(12c)) 
s3c24xx i2c disable ack(i2c); 
} else if (is msgend(12c)) 1 
if(is lastmsg(12c)) { 
Pie ANK FRIES 
dev dbg(i2c->dev "READ: Send Stop n"); 
s3c24xx i2c stop(i2c, 0); 


E 
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7.4 


7.4.1 


} else ( 
f^ 1p —A Esso 
dev dbg(i2c->dev "READ: Next Transfer n"); 
i2c-^msg ptr = 0; 
i2c-2msg idx++; 
i2c->msg++,; 


break; 


out ack: 


out: 


tmp = readl(i2c-^regs + $33C2410 IICCON); 
tmp &- —$S3C2410 IICCON IRQPEND; 
writel(tmp, i2c->regs + S33C2410 IICCON); 


return ret; 


通用 DC 从 设备 


通用 DC 从 设备 驱动 
/drivers/i2c/i2c-dev.c 为 DC 设备 提供 了 通用 的 应 用 层 访问 接口 ， 即 read, write 以 及 ioctl 


等 文人 


Hid. 


应 用 层 根 据 /dewi2c-* 的 主 设备 号 寻找 file_operations， 根 据 /dev/i2c-* 的 次 设 1 


相应 的 i2e. adapter 结构 。 


内 核 在 i2c_dev_init 函数 中 将 I2C. MAJOR 设备 号 与 i2cdev_fops 关联 起 来 。 
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static const struct file operations i2cdev fops = { 


3s 


„owner = THIS MODULE, 
.seek = no llseek, 

read — i2cdev read, 

.write = i2cdev_ write, 
.unlocked ioctl = i2cdev 1octl, 
.open — i2cdev open, 
release — i2cdev release, 


static int — initi2c dev init(void) 


1 


int res; 
printk(KERN INFO "12c /dev entries driver n"); 
res = register chrdev(I2C MAJOR, "i2c", &i2cdev fops); 
if (res) 
goto out; 
12c dev class = class create(THIS MODULE, "i2c-dev"); 


号 寻找 
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if(IS ERR(i2c dev class)) { 
res = PTR. ERR(i2c dev class); 
goto out unreg chrdev; 
} 
i2c dev class->dev groups —i2c groups; 
PER PG E AME E THEE AI/ 
res — bus register notifier(&i2c bus type, &i2cdev notifier); 
if (res) 
goto out unreg class; 
PEEEXIUG Hx i as */ 
i2c for each dev(NULL, i2cdev attach adapter); 
return 0; 
out unreg class: 


class destroy(i2c dev class); 
out unreg chrdev: 
unregister chrdev(I2C MAJOR, "i2c"); 


out: 
printkK(KERN ERR "%s: Driver Initialisation failedin", FILE  ); 
return res; 

j 

inti2c for each dev(void *data, int (*fn)(struct device *, void *)) 

{ 
int res; 


mutex_lock(&core_lock); 
res = bus for each dev(&i2c bus type, NULL, data, fn); 
mutex unlock(&core lock); 


return res; 


j 


通用 DC 设备 打开 的 时 候 会 根据 次 设备 号 寻找 相应 的 DC 适配器 ， 而 适配器 驱动 提供 了 数 
i PR A 


static int I2cdev open(struct inode *inode, struct file *file) 
1 
unsigned int minor = iminor(inode); 
struct i2c client *client; 
struct i2c adapter *adap; 
struct i2c dev *i2c dev; 
i2c dev=i2c dev get by minor(minor); 
if(li2c dev) 
return -ENODEV; 
adap —i2c get adapter(i2c_dev->adap->nnD;/ 获 取 适 配器 
if (ladap) 
return -ENODEV; 
// 分 配 一 个 i2c_client 
client = kzalloc(sizeof(*client), GFP KERNEL); 
if (!client) { 
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i2c put adapter(adap); 
return -ENOMEM; 

j 


snprintf(client-»name, I2C NAME SIZE, "i2c-dev %d", adap-nr); 


client->adapter = adap; 
file-72private data = client; 
return 0; 


j 


DC 设备 的 节点 


AN 


还 支持 一 些 IOCTL 命令 ， 如 表 7-3 所 示 。 


表 7-3 I2C 节点 支持 的 IOCTL 命令 


IOCTL 代码 


说 明 


ioctl(file, DPC_SLAVE, long addr) 


修改 从 设备 地 址 


ioctl(file, DC_TENBIT, long select) 


Select 二 0; 从 设备 地 址 为 7 位 ， 和 否则 为 10 位 


ioctl(file, DC_TIMEOUT, long timeout) 


超时 时 间 设 置 


ioctl(file, I2C PEC, long select) 


SMBus 包 错 误 校 验 (Packet Error Checking) 使 能 ; 
select —0 禁止 ， 和 否则 人 允许 


ioctl(file, DC_ FUNCS, unsigned long *funcs) 


获取 DC 适配器 功能 


ioctl(file, DC_ RDWR, struct i2c rdwr ioctl data *msgset) 


连续 的 读 写 操作 


ioctl(file, DC_SMBUS, struct i2c smbus ioctl data *args) 


传输 SMBus 数据 


7.4.2 ”通过 read 5j write 接口 读 写 
通过 read. write 函数 读 写 DC 设备 ， 首 先 调 用 IOCTL 设置 DC 参数 : 
#define DC SLAVE 0x0703 /* M i e Hh 
define I2C_ SLAVE FORCE 0x0706 /强制 使 用 本 地 址 ， 即 使 这 个 地 址 被 其 他 驱动 使 用 */ 
#define I2C_ TENBIT 0x0704 # 地 址 长 度 设 置 ，0 表示 7bit 地 址 , JE 0 表示 10bit 地 址 */ 
次 调用 read 或 write 函数 进行 读 或 者 写 ， 读 写 是 分 开 的 。 下 面 来 分 析 i2cdev_write 的 处 
理 过 程 。i2cdev_write 代码 如 下 : 


static ssize t i2cdev write(struct file *file, const char _ user *buf,size t count, loff t *offset) 


1 
int ret; 


char *tmp; 


struct i2c client *client = file-^private data; 
/最 大 的 写字 节 数 


if (count > 8192) 

count — 8192; 
tmp = memdup user(buf, count); 
if(IS ERR(tmp)) 

return PTR. ERR(tmp); 


I/S 


BIZA 


JEZ 


pr debug("i2c-dev: 12c-%d writing %zu bytes.\n", 


iminor(file inode(file)), count); 


ret=i2c master send(client, tmp, count); 


kfree(tmp); 
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return ret; 


j 
显然 ，i2cdev_write 函数 先 将 用 户 数据 复制 到 内 核 空 间 后 ， 再 调用 i2c master send 函数 : 


inti2c master send(const struct i2c client *client, const char *buf, int count) 


1 
int ret; 
struct i2c adapter *adap = client-^adapter; 
struct i2c msg msg; 
msg.addr = client-^addr; 
msg.flags = client-^flags & IDC M TEN; 
msg.len — count; 
msg.buf = (char *)buf; 
ret = i2c transfer(adap, &msg, 1); 
/发 送 成 功 返 回 字 节 数 ， 否 则 返回 错误 值 
return (ret — 1) ? count : ret; 

j 


i2c master send 函数 中 填写 了 struct i2c msg 结构 ， 包 含 了 从 机 地 址 、 数 据 、 数 据 长 度 等 信 
息 。i2c_master_send 函数 最 后 调用 了 i2c_transfer 函数 ; 


inti2c transfer(struct i2c adapter *adap, struct i2c msg *msgs, int num) 
1 
int ret; 
if (adap->algo->master xfer) { 
if (in atomic() || irgs disabled()) { 
ret —i2c trylock adapter(adap); 
if (lret) 
return -EAGAIN; /*I2C 正 


D WE 


} else { 
i2c lock adapter(adap); 
} 
ret-  i2c transfer(adap, msgs, num); 
i2c unlock adapter(adap); 
return ret; 
) else { 
dev dbg(&adap-^dev, "I2C level transfers not supportedin"); 
return -EOPNOTSUPP; 


j 


. ji2c transfer 函数 最 终 调用 了 adap->algo->master xfer 函数 来 实现 数据 收发 。master xfer K 
数 原型 如 下 : 


int master xfer(struct i2c. adapter* adapter, struct i2c msg *msg, int num) 


AA 一 一 


master xfer 实际 上 实现 了 DC 发 送 数据 时 序 。master xfer 的 第 二 个 参数 是 2c msg 结构 ， 第 三 
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个 参数 是 消息 的 个 数 。i2c_msg 结构 定义 如 下 : 


struct i2c msg { 


. ul6 addr;/* P ve ee Hh */ 
_u16 flags;/* 消 息 标志 ， 芯 片 地 址 类 型 、 读 写 标志 、ACK 标志 */ 
. ul6len;/*ibj EIS EEV/ 


. u8 *buf;/* 消 息 数据 */ 
5 
i2cdev read 的 过 程 与 i2cdev_write 类 似 ， 不 再 鳌 述 。 
例 7.1 I2C 通用 设备 读 写 实例 
本 例 为 应 用 层 代 码 ， 实 现 对 AT24C02 的 读 写 。I2C 设备 读 写 操作 的 数据 格式 要 根据 具体 
的 芯片 确定 。AT24C02 的 读 写 时 序 见 本 章 第 1 节 。 


#define CHIP ADDR 0x50 / 设备 地 址 
#define PAGE SIZE 8 1 页 写 六 大 小 
#define I2C DEV — "/dev/i2c-1" 
static int read eeprom (int fd,char buff] |.int addr,int count) 
1 

int res; 

if (write(fd,&addr, 1)!—1) // 写 地 址 失败 

return -1; 

res—-read(fd,buff,count); 

printf("read %d byte at 0x Vox n",res,addr); 

return res; 
j 
/缓冲 区 不 能 超过 一 页 
static int write eeprom (int fd, char buff] ],int addrint count) 
1 


int res; 


int i; 
static char sendbuffer[PAGE SIZE-1]; 
memopy(sendbuffer + 1,buff,count); 
sendbuffer[0] — addr; 
res = write(fd,&sendbuffer,count + 1); 
printf("write %d byte at 0x9ox n" ,res,addr); 
j 
int main(void) 
{ 
int fd,n,res; 
unsigned char buf[PAGE_SIZE]={1,2,3,4,5,6,7,8%; 
fd = open(I2C DEV,O RDWR); 
if(fd«0) 
{ 
printf("####i2c test device open failed ####\n"); 
return(-1); 
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res = ioctl(fd,I2C_TENBIT,0); /地 址 为 7 位 模式 
res = ioctl(fd,I2C SLAVE,CHIP ADDR);/ 设 置 2C 从 设备 地 址 
write eeprom(fd,buf,O,sizeof(buf)); 
memset(buf,0,sizeof(buf)); 
read eeprom(fd,buf)O,sizeof(buf)); 
for(n- 0;ncsizeof(buf);n-—) 
1 
printf("Ox9oxWM",buf[n]); 
} 
close(fd); 


7.4.3 通过 IC_RDWR 命令 读 写 


通过 DC RDWR 命令 可 以 实现 读 写 的 混合 操作 ， 这 样 方便 按照 芯片 时 序 的 要 求 组 装 合适 的 
IC 消息 。 先 看 看 Cdev 设备 的 ioctl 实现 : 


static long i2cdev_ioctl(struct file *file, unsigned int cmd, unsigned long arg) 


{ 

switch (cmd) { 

case I2C_RDWR: 

return i2cdev ioctl rdwr(client, arg); 

j 
j 
static noinline int i2cdev ioctl rdwr(struct i2c. client *client;unsigned long arg) 
1 


struct i2c rdwr ioctl data rdwr arg; 


struct i2c msg *rdwr pa; 
ug user **data ptrs; 
int 1, res; 
// 先 从 用 户 空 间 获取 i2c_rdwr ioctl data 结构 
if (copy_from user(&rdwr arg, (struct i2c rdwr ioctl data — user *)arg,sizeof(rdwr arg))) 
return -EFAULT; 
// 判 断 消 息 数据 是 否 超标 
if (rdwr arg.nmsgs > I2C RDWR IOCTL MAX MSGS) 
return -EINVAL; 
/进一步 从 用 户 空间 复制 消息 数据 
rdwr pa= memdup user(rdwr arg.msgs,rdwr arg.nmsgs * sizeof(struct i2c msg)); 
if (IS ERR(rdwr pa)) 
return PTR. ERR(rdwr pa); 
data ptrs = kmalloc(rdwr arg.nmsgs * sizeof(u8 — user *), GFP KERNEL); 
if (data ptrs == NULL) 1 
kfree(rdwr pa); 
return -ENOMEM; 


j 


res = 0; 
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for (i = 0; i < rdwr arg.nmsgs; i++) { 
PIA AE K ES 
if (rdwr palil.len > 8192) { 
res = -EINVAL; 
break; 
j 
data ptrs[i] = (u8 __user *)rdwr palil.buf; 
rdwr pa[i].buf = memdup user(data ptrs[i], rdwr pa[i].len); 
if(IS ERR(rdwr pa[i].buf)) { 
res = PTR. ERR(rdwr palil.buf); 
break; 
j 
/确保 缓冲 足够 
if (rdwr pa[1].flags & I2C M RECV LEN) { 
if (rdwr pa[i].flags & I2C M RD) || 
rdwr pa[i].buf[0] < 1 || 
rdwr pa[i].len < rdwr pa[i].buf[0] -I2C SMBUS BLOCK MAX) { 


res = -EINVAL; 
break; 
} 
rdwr pa[i].len = rdwr pa[i].buf[0]; 
j 
} 
if (res < 0) ( 
int j; 
for(j -0;j < i; +j) 
kfree(rdwr pa[j].buf); 
kfree(data ptrs); 
kfree(rdwr pa); 
return res; 
} 
/传输 数据 


res = i2c transfer(client->adapter, rdwr pa, rdwr arg.nmsgs); 
while (1-- > 0) ( 
if (res >= 0 && (rdwr pa[i].flags & I2C M RD)) ( 
if(copy to user(data ptrs[i], rdwr pa[i].bufjrdwr pa[i].len))//3& H] 


H 
x 
28 
NR 


由 


res = -EFAULT; 
} 
kfree(rdwr pa[i].buf); 
j 
kfree(data ptrs); 
kfree(rdwr pa); 
return res; 


j 
下 面 介 绍 应 用 层 的 编码 。 打 开设 备 的 方法 与 上 一 节 相 同 。I2C_RDWR 传输 的 结构 如 下 : 


struct i2c rdwr ioctl data { 
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EE 
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struct i2c msg user *msgs;*i2c msgs 指针 */ 
. u32nmsgs; [*i2c msgs 数量 */ 


写 需要 根据 芯片 的 时 序 来 编写 代码 。 不 同 芯片 的 寄存 器 地 址 与 数字 类 
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的 DC 设备 是 8bit 寄存 器 8bit 数据 类 型 ， 有 的 则 是 16bit 寄存 器 Sbit 数据 类 型 。 
是 根据 AT24C02 的 时 序 实现 的 : 


struct i2c rdwr ioctl data i2¢ data r; 


struct i2c msg i2c msgs r[2]; 


struct i2c msg i2c msgs w[2]; 


unsigned char ReadI2C(unsigned char dev,unsigned char addr) 


1 


j 


unsigned char bufp[2]; 
int ret=0; 
memset(bufp,0,2); 
if(m fd«O)return OxFF; 
pthread mutex lock(&m mux); 
bufp[0]-addr; 
i2c msgs r[0].buf 2&bufp[0] ; 
i2c msgs r[0].len = 1; 
i2c msgs r[0].flags = 
i2c msgs r[0].addr = dor 
i2c msgs r[1].buf — &bufp[1]; 
i2c msgs r[1].len = 1; 
i2c msgs r[1].flags = I2C M RD; 
i2c msgs r[1].addr = dev; 
i2c data r.msgs = i2c msgs r; 
i2c data r.nmsgs = 2; 
ret = ioctl(fd,I2C_ RDWR,(unsigned long)&i2c data r); 
if(ret«0) 
1 
printf("read i2c device Error(?6d):0x96.2x 0x96.2x" ret, dev,addr); 
j 
pthread mutex unlock(&m mux); 
return bufp[1]; 


int WriteI2C(unsigned char dev,unsigned char addr,unsigned char value) 


1 


unsigned char bufp[2]; 

int ret=0; 

memset(bufp,0,2); 

if(m fd«O)retum -1; 

pthread mutex lock(&m mux); 
bufp[0]-addr; 

bufp[1]-value; 

i2c msgs w[0].buf = bufp; 


型 不 同 。 


F 面 的 代 
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i2c msgs w[0].len = 2; 
i2c msgs w[0].addr = dev; 
i2c msgs w[0].flags = 0; 
i2c data w.msgs —i2c msgs w; 
i2c data w.nmsgs = 1; 
ret = ioctl(m fd,I2C RDWR,(unsigned long)&i2c data w); 
if(ret«0) 
1 
print("write i2c device Error(V6d):0x90.2x 0x90.2x"ret,dev,addr); 
} 
usleep(1); 
pthread mutex unlock(&m mux); 
return ret; 


} 
7.4.4 I2Ctools 


I2Ctools 工具 包 提 供 了 一 组 DC 工具 ， 包 括 i2cdetect、i2cset、i2cget、i2cdump 等 。 通 过 
DCtools 工具 可 直接 对 DC 芯片 进行 操作 。I2Ctools 利用 的 就 是 通用 DC 从 设备 驱动 。 
i2cdetect 命令 可 扫描 DC 适配器 ， 用 法 如 下 : 


[root(Qurbetter /homel# ./i2cdetect -1 
12c-0 12c s3c2410-i2c I2C adapter 
12c-1  i2c s3c2410-i2c I2C adapter 


i2cdetect 命令 还 可 扫描 DC 从 设备 ， 例 如 : 


[root@urbetter /home]-—£ 12cdetect -y -r 1 

Q 1 2 3 4 8$ $ 7 S 9 $9 bed e 
00: -- -- -- -- -- -- -- -- -- -- -- -- -- 
10: -- -- -- -- UU -- -- -- UU -- -- -- -- -- -- -- 


20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 

30: -- -- -- -- -- -- -- -- 38 -- -- -- -- -- -- 3f 
40: -- -- -- -- -- -- -- -- -- -- UU UU -- -- -- -- 
50: 50-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 


Beca E E 


Toe 


上 面 的 结果 中 ， 检 测 到 的 数字 (Gs. 3f. 500 代表 挂 载 的 PC 设备 地 址 。UU 表示 这 个 
PC 设备 地 址 存在 ， 但 已 经 注册 为 个 性 化 PC 从 设备 ， 也 就 是 被 内 核 某 个 I2C 驱动 使 用 。 

DC 从 设备 读 使 用 i2cget 命令 ， 从 设备 写 使 用 i2cset 命令 ， 命 令 参 数 若 未 添加 -y 参数 ， 
表示 需要 交互 确认 。I2C 从 设备 具有 设备 地 址 以 及 数据 或 寄存 器 地 址 。 设 备 地 址 用 来 区 分 设 
fe. 数据 或 寄存 器 地 址 用 来 在 从 设备 内 部 进行 寻 址 。 

[root@urbetter /home]:~# i2cset 1 0x50 0x18 0x00 


WARNING! This program can confuse your I2C bus, cause data loss and worse! 
I will write to device file /dev/i2c-1, chip address 0x50, data address 
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0x18, data 0x56, mode byte. 

Continue? [Y/n] y 

root@dm816x-evm:~# i2cgetl 0x50 0x18 

WARNING! This program can confuse your I2C bus, cause data loss and worse! 
I will read from device file /dev/12c-1, chip address 0x50, data address 

0x18, using read byte data. 

Continue? [Y/n] y 

0x56 


i2cdump 可 批量 导出 DC 从 设备 数据 : 


这 


[root(Qurbetter /home]./i2cdump -y 1 0x50 


个 命令 将 导出 PC 总 线 1 上 的 0x50 UCET 0x00~0xFF 地 址 范围 的 数据 。 


7.5 个 性 化 I2C 从 设备 驱动 


DC 接口 实际 上 只 是 一 种 通信 接口 ， 而 DC 从 设备 具备 自己 的 独特 功能 ， 这 些 功 能 包括 


[m] 


HH 


m 


EEPROM、 视 频 AD 芯片 、 摄 像 头 芯片 、RTC 芯片 、 音 频 芯 片 。 这 就 造成 了 很 多 IC 从 设备 


然 依 赖 DC 驱动 ， 但 放 到 了 其 他 驱动 程序 代码 下 面 ， 是 一 种 混合 型 驱动 。 本 书 将 在 内 核 


L 


注册 的 PC 从 设备 驱动 称 为 个 性 化 PC 从 设备 驱动 ， 以 区 别 于 上 面 提 及 的 通用 DC 从 设备 驱 
动 。 本 节 以 pcf8583 蔚 片 为 例 说 明 个 性 化 DC 从 设备 驱动 的 开发 方法 。 


static const struct rtc class ops pcf8583 rtc ops- 1 
read time = pcf8583 rtc read time, 
.Set time — pcf8583 rtc set time, 
h 
static int pcf8583 probe(struct i2c client *client,const struct i2c. device id *id) 
1 
struct pcf8583 *pcf8583; 
/检查 I2C 适配器 功能 
了 (li2c_check functionality(client-^adapter, DC_ FUNC 12C)) 
return -ENODEV; 
pcf8583 = deym kzalloc(&client-^dev, sizeof(struct pcf8583), GFP KERNEL); 
if (!pcf8583) 
return -ENOMEM; 
12c set clientdata(client, pcf8583); 
// 注 册 RTC 驱动 
pecf8583->rtc = devm rtc device register(&client-^dev,pcf8583 driver.driver.name, 
&pcf8583 rtc ops, THIS MODULE); 
return PTR ERR. OR. ZERO(pcf8583-^rtc); 


} 
static struct i2c driver pcf8583 driver = { 
.driver = ( 
.name = "pcf8583", 
H pi 
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.probe = pcf8583 probe, 
Jd table = pcf8583 1d, 
h 
module i2c driver(pcf8583 driver); 
注册 为 PC 从 设备 之 后 ， 本 驱动 可 以 调用 D2C 驱动 层 的 函数 接口 。 可 见 pcfS583 probe 
函数 中 注册 了 一 个 RTC 驱动 程序 。 


Rui 


static int pcf8583 rtc read time(struct device *dev, struct rtc time *tm) 
1 

struct i2c client *client = to i2c client(dev); 

unsigned char ctrl, year[2]; 

struct rc mem mem = { 
Joc = CMOS YEAR, 
.nr = sizeof(year), 
.data = year 

je 

int real year, year offset, err; 

/确保 PCF8583 正常 运行 

pcf8583 get ctrl(client, &ctrl); 

if (ctl & (CTRL STOP | CTRL HOLD)) { 
unsigned char new ctrl = ctrl & —(CTRL STOP | CTRL HOLD); 
dev warn(dev, "resetting control %02x -> %02x\n",ctrl, new ctrl); 
err = pcf8583 set ctrl(client, &new ctrl); 
if (err « 0) 

return err; 

j 

/获取 时 间 

if (pcf8583 get datetime(client, tm) ||pcf8583 read mem(client, &mem)) 
return -EIO; 

//RIC 只 包含 年 份 后 的 十 位 与 个 位 ， 需 要 年 份 转换 
real year — year[0]; 


year offset = tm-^tm year - (real year & 3); 
if (year offset « 0) 
year offset += 4; 
/转换 为 公元 年 份 
tm->tm year = (real year + year offset + year[1] * 100) - 1900; 


return 0; 


j 
pcf8583 rtc read time 调用 了 pcf8583 get datetime PÁ ŽI: 


static int pcf8583 get datetime(struct i2c client *client, struct rtc time *dt) 


1 
unsigned char buf[8], addr[1] = {1}; 
struct 2c msg msgs[2] = 1 
1 
.addr = client->addr, 
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.flags = 0, 
Jen 1, 
.buf — addr, 
bi 
.addr = client--addr, 
flags = 2C M RD, 
Jen — 6, 
.buf = buf, 


h 

int ret; 

memset(buf, 0, sizeof(buf)); 

ret = i2c transfer(client-^adapter, msgs, 2); 

if (ret — 2) ( 
dt-^tm year = buf[4] >> 6; 
dt-^tm wday = buf[5] >> 5; 
buf[4] &= 0x3f; 
buf[5] &= 0x1f; 
dt-^tm sec = bed2bin(buf[1]); 
dt-^tm min = bed2bin(buf[2 ]); 
dt-^tm hour = bcd2bin(buf[3]); 
dt-^tm mday = bcd2bin(buf[4]); 
dt-^tm mon = bcd2bin(buf[5]) - 1; 

} 

return ret — 2 ? 0 : -EIO; 

} 


看 到 了 i2c transfer 函数 ， 那 就 是 DC 适 配 占 层 的 事情 了 。 那 么 这 个 pcf8583 Dc 从 设备 
是 如 何 挂 载 到 I2C 控制 器 上 的 呢 ? 在 板 级 的 初始 化 代码 中 要 注册 DC 板 级 设备 信息 。 例 如 : 


static struct i2c board infoi2c rtc = ( 
I2C BOARD INFO("pcf8583", 0x50) 


h 
static int — init rpc. init(void) 
1 
i2c register board info(0, &12c rtc, 1); 
return platform add devices(devs, ARRAY SIZE(devs)); 
} 


i2c register board info 函数 将 2C 板 级 设备 信息 添加 到 _i2c board list 中 。i2c_register_ 
board info 函数 第 一 个 参数 就 是 DC 总 线 号 ， 这 就 表示 设备 会 挂 载 到 busnum 所 对 应 的 DC 
总 线 上 。 


int  initi2c register board info(int busnum,struct i2c board info const *info, unsigned len) 


1 


int status; 
down write(& i2c board lock); 
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Pii DC 总 线 号 */ 


if (busnum >=  i2c first dynamic bus num) 


i2c first dynamic bus num = busnum + 1; 
for (status = 0; len; len--, info) { 

struct i2c devinfo *devinfo; 

devinfo = kzalloc(sizeof(*devinfo), GFP KERNEL); 

if (!devinfo) { 
pr debug("i2c-core: can't register boardinfo'\n"); 
status = -ENOMEM; 
break; 


j 


devinfo-^busnum = busnum; 
devinfo->board info = *info; 
list add tail(&devinfo-^list, & | 12c board list); 
j 
up write(& — i2c board lock); 
return status; 


而 在 i2c register adapter 函数 中 会 调用 i2e scan static board info 扫描 这 些 静 态 的 板 级 


设备 : 


static int 12c register adapter(struct i2c adapter *adap) 


1 
if (adap->nr <  i2c first dynamic bus num) 
12c scan static board info(adap); 
} 
static void i2c scan static board info(struct i2c adapter *adapter) 
1 
struct i2c devinfo ^ *devinfo; 
down read(&  12c board lock); 
list for each entry(devinfo, & i2c board list, list) { 
if (devinfo-^busnum == adapter-^nr 
&& !i2c new device(adapter,&devinfo-^board info)) 
dev err(&adapter-^dev,"Can't create device at 0x96002x n",devinfo-^board info.addr); 
} 
up read(& i2c board lock); 
} 


当 从 设备 的 总 线 号 与 适配器 的 总 线 号 一 致 时 ， 会 调用 i2c new device 函数 创建 新 的 
i2c_client。 有 了 i2c_client， 后 面 的 PC 操作 就 顺理成章 了 。 除 了 ic transfer FRI, 3 F 
面 的 函数 可 以 读 写 PC 设备 : 


s3212c smbus read byte(const struct i2c_client *client); 

s3212c smbus write byte(const struct i2c client *client, u8 value); 

s32i2c smbus read byte data(const struct i2c client *client, u8 command); 

s3212c smbus write byte data(const struct i2c client *client, u8 command,u8 value); 
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pb 


TTY 是 Teletype 的 缩写 ，Teletype 是 一 种 由 Teletype Zr] ^] 


mu 


Hi 


TTY 与 串口 驱动 程序 


E 产 的 电 传 打字 机 设备 。 电 传 打 


字 机 最 终 被 键盘 和 显示 器 终端 所 取代 。 在 Linux 中 TTY 用 来 表示 各 种 终端 。 终 端 通常 都 和 硬 
也 有 对 应 于 虚拟 设备 的 pty 驱动 程序 。Linux 为 众多 的 终端 设备 建立 


件 对 应 ， 例 如 串口 终端 。 


AE 


了 统一 的 模型 。 


Linux H 


8.1 TTY 概念 


P TTY 设备 驱动 体系 以 及 串口 驱动 


发 的 相关 知识 。 


Teletype 是 最 早 的 终端 设备 ，TTY 是 Teletype 的 缩写 。 在 Linux 操作 系统 中 ，TTY 代表 


终端 设备 。Linux H 


主要 包含 控制 台 、 串 口 和 伪 终 端 三 类 终端 设备 。 


(1) 串 行 端口 终端 〈/dewttySACn ) 


(2) Him C/dev/pty) 
伪 终 端 (Pseudo Terminal) 


(3) 控制 台 终 端 (/dev/ttyn, /dev/console) 


串 行 端口 终端 (Serial Port Terminal) 是 使 用 串 行 端口 连接 的 终端 设备 ， 这 些 串 行 端口 所 
对 应 的 设备 名 称 是 /dewttySAC0 (或 /dev/tts/0)、/dev/ttySAC1 


(或 /dev/tts/1 ) 等 。 


是 不 对 应 于 具体 硬件 的 终端 ， 它 的 名 称 类 似 于 /dev/ptypn、 
/devittypn。 通 常 伪 终 端 用 来 作为 程序 间 通信 的 逻辑 设备 ， 使 用 /devittypn 的 程序 会 认为 自己 
正在 与 一 个 品行 端口 进行 通信 。 


控制 台 终 端 〈Console) 通常 对 应 于 计算 机 显示 器 ， 与 之 关联 的 设备 文件 是 ttyO. ttyl, 


tty2 等 。 控 制 


终端 是 操作 系统 的 人 机 接口 。 
在 Linux 中 ， 可 以 在 系统 启动 命令 行 里 指定 当前 的 控制 台 终端 ， 


console-device, options 


device X7 


KR 终端 设备 ， 可 以 是 tty0. ttySACn. Ip0 ^. options 是 对 device 的 设置 的 


格式 如 下 : 


述 ， 它 取决 于 具体 的 设备 驱动 程序 。 对 于 串口 设备 ， 参 数 用 来 定义 波 特 率 、 校 验 位 、 位 数 ， 


格式 为 BBBBP 
是 9600n8。 下 


console-ttySACO,115200 


面 是 一 个 Linux 启动 命令 行 中 控制 台 设 置 的 例子 : 


8.2 Linux TTY 驱动 程序 体系 


8.2.1 TTY 驱动 程序 架构 
Linux 中 TTY 驱动 程序 代码 目录 在 /driverstty 下 面 。TTY 的 层次 结构 包括 TTY 应 用 


Linux 驱动 程序 开发 实例 


层 、TTY 文件 层 
i245. TTY XH 


、TTY 线路 
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规程 层 、TTY JANE. TTY 设备 驱动 层 。TTY 应 用 层 负责 应 用 


F 层 负责 文人 


FEO. TTY 线路 规程 负责 串 行 通信 协议 处 理 ， 包 括 特定 协议 


(例如 PPP 和 Bluetooth〉 的 封装 与 解 封 。TTY 驱动 层 实现 对 各 种 TTY 类 型 的 分 类 与 抽象 。 
TTY 设备 驱动 层 实现 具体 的 TTY 设备 (芯片 或 控制 器 〉 的 驱动 ， 即 设备 配置 与 数据 收发 。 


名 


8-1 为 Linux ff] TTY Jj 


K 动 程序 架构 网 。 


/dev/ttySn 


/dev/tty/USBn /dev/pty 


tty xc f | 


In 


822 TTY 文件 层 


E OBKZ) (uart driver) 


串口 设备 驱动 


USB 串 口 驱动 
(usb serial driver) 


USB 串 口 设 备 驱动 VT 设备 驱动 


图 8-1 TTY 驱动 程序 架构 


EHI 
驱动 


TTY 设备 的 文件 操作 接口 如 下 : 
static const struct file operations tty fops = { 
.llseek = no llseek, 
read — tty read, 
write =tty_write, 
.poll = tty poll, 
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unlocked ioctl 
.compat ioctl- tty compat ioctl, 


= tty ioctl, 


.open —tty open, 
release —tty release, 
.fasync —tty fasync, 
h 
static const struct file operations console fops = { 
.llseek = no llseek, 
read — tty read, 
.write — redirected tty write, 
.poll = tty poll, 


unlocked ioctl 
.compat ioctl- tty compat ioctl, 


— tty ioctl, 


.open —tty open, 
release —tty release, 
.fasync = tty fasync, 
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ls 


在 tty init 函数 中 注册 了 5 号 (TTYAUX. MAJORO TTY 设备 ， 并 设置 了 该 TTY 设备 的 


文件 操作 接 


int _inittty init(void) 
1 
/tty 设备 
cdev init(&tty cdev, &tty fops); 
if (cdev add(&tty cdev MKDEV(TTYAUX MAJOR, 0), 1) || 
register chrdev region(MKDEV(TTYAUX MAJOR, 0), 1, "/dev/tty") « 0) 
panic(" Couldn't register /dev/tty driver"); 
/创建 设备 节点 
device create(tty class, NULL, MKDEV(TTYAUX MAJOR, 0), NULL, "tty"); 
// 控 制 台 设备 
cdev init(&console cdev, &console fops); 
if (cdev add(&console cdev MEDEV(TTYAUX MAJOR, 1), 1) || 
register chrdev region(MKDEV(TTYAUX MAJOR, 1), 1, "/dev/console") < 0) 
panic("Couldn't register /dev/console driver"); 


consdev — device create with groups(tty class, NULL, 
MKDEV(TTYAUX MAJOR, 1), NULL, 
cons dev groups, "console"); 
if (IS ERR(consdev)) 
consdev = NULL; 
#ifdef CONFIG VT 
vty init(&console fops); 
#endif 
return 0; 


} 


device create with groups 函数 功能 与 device create 图 数 差 不 多 ， 只 是 比 device create 多 
一 个 attribute_group 类 型 的 参数 。 除 了 tty_init 函数 中 会 注册 TTY 字符 设备 外 ， 当 tty_driver 


结构 的 flags 成 员 设 置 为 动态 分 配 (TTY DRIVER DYNAMIC ALLOC) 或 者 动态 设备 
(TTY DRIVER DYNAMIC DEVO 时 ，TTY 驱动 注册 函数 tty register driver 会 调 月 


tty cdev add PAIS JI — ^ tty 字符 设备 : 
static int tty cdev add(struct tty driver *driver, dev t dev;unsigned int index, unsigned int count) 
{ 
int err; 
POBRE IRRE I 
driver-^»cdevs[index] = cdev. alloc(); 
if (!driver-^cdevs[index]) 
return -ENOMEM; 
driver-^cdevs[index]-^ops = &tty fops; 
driver-7cdevs[index ]-^owner = driver->owner; 
err = cdev add(driver-»cdevs|[index], dev, count); 
if (err) 
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kobject put(&driver->cdevs[index]->kobj); 


return err; 


8233 ”线路 规程 层 


线路 规程 Cline discipline〉 是 TTY 文件 层 与 TTY 驱动 层 的 中 间 层 ， 主 要 负责 TTY 的 协 
议 层 。 线 路 规程 使 用 tty ldisc 结构 描述 ，struct tty_ldisc 包含 两 类 接口 ， 一 类 是 面向 上 层 供 


TTY 核心 层 调 用 的 ， 另 一 类 是 面向 下 层 供 TTY 驱动 程序 调用 的 。 


structtty ldisc ops ( 
int magic; 
char *name; 
int num; 
int flags; 
/TTY 核心 层 调用 
int (*open)(struct tty struct *); 
void (*close)(struct tty struct *); 
void (*flush buffer)(struct tty struct *tty); 


Ssize t (*chars in buffer)(struct tty. struct *tty); 
ssize t (*read)(struct tty struct *tty, struct file *filejunsigned char — user *buf, size t nr); 
ssize t (*write)(struct tty struct *tty, struct file *file,const unsigned char *buf, size t nr); 


int (*ioctl)(struct tty struct *tty, struct file *file,unsigned int cmd, unsigned long arg); 

long (*compat ioctl)(struct tty struct *tty, struct file *file,unsigned int cmd, unsigned long arg); 
void (*set termios)(struct tty struct *tty, struct ktermios *old); 

unsigned int (*poll)(struct tty struct *, struct file *,struct poll table struct *); 

int (*hangup)(struct tty struct *tty); 

/下 层 TTY 驱动 程序 调用 


void (*receive buf)(struct tty struct *, const unsigned char *cp,char *fp, int count); 


void (*write wakeup)(struct tty struct *); 
void (*dcd change)(struct tty struct *, unsigned int); 
void (*fasync)(struct tty struct *tty, int on); 
int (*receive buf2)(struct tty struct *, const unsigned char *cp,char *fp, int count); 
struct module *owner; 
int refcount; 
h 
struct tty ldisc ( 
struct tty ldisc ops *ops; 
struct tty struct *tty; 
h 


注册 一 种 线路 规程 使 用 tty register ldisc 函数 : 


disc 是 线路 规程 号 ，new_ldisc 是 要 注册 的 线路 规程 。 内 核 中 有 一 个 线路 规程 
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inttty register ldisc(int disc, struct tty ldisc ops *new ldisc) 


JL 
i 
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static struct tty ldisc ops *tty ldiscs[INR LDISCS]; 


tty register ldisc 函数 将 新 的 线路 规程 加 入 到 线路 规程 表 中 。 内 核 中 已 经 定义 的 线路 规程 
如 下 : 


#define N TTY 0 
#define N SLIP 1 
#define N MOUSE p 
#define N PPP 3 
#define N STRIP 4 
#define N AX25 3 

6 


Ztdefine N. X25 /*X.25 async*/ 


#define N 6PACK 7 

#define N MASC 8 /*Jj Mobitex module <kaz@cafe.net> 保留 */ 
define N R3964 9 /*7j Simatic R3964 module 保留 */ 

#define N PROFIBUS FDL ”10/* 为 Profibus 保留 */ 

#define N_IRDA 11 /*IrDa*/ 

#define N SMSBLOCK 12 /*SMS block mode - for talking to GSM data*/ 
#define N HDLC 13 /*synchronous HDLC*/ 

#define N SYNC PPP 14 /*synchronous PPP*/ 

#define N NCI 25 /*NFC NCI UART*/ 


TTY 设备 在 初始 化 时 被 绑 定 到 N_TTY 号 线路 规程 。 内 核 启 动 时 会 初始 化 N_TTY 号 线 
路 规程 : 


void tty ldisc begin(void) 


{ 
/* ELERA HI TTY line discipline.*/ 
(void) tty register ldisc(N TTY, &tty_ldisc_N_TTY); 
j 
void init console init(void) 
1 
initcall t *call; 
tty ldisc begin(); 
call= — con initcall start; 
while(call < — con initcall end) { 
(*call)(); 
call; 
j 
j 
asmlinkage void — init start kernel(void) 
{ 


console_init(); 
if (panic later) 


panic(panic later, panic. param); 
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lockdep info(); 
locking selftest(); 
j 


zn Doo 


应 用 
82.4 TTY 驱动 层 


JH IOCTL 命令 (TIOCSETD) 切换 双 


t 


K 动 的 线路 规程 


tty driver 结构 描述 一 种 TTY 驱动 程序 : 
struct tty driver { 
int magic; /# 本 结构 的 magic number*/ 
struct kref kref, ~n AE RES 
struct cdev **cdevs; /字符 设备 
struct module*owner; 
const char *driver name; 
const char — *name; 
int name base; —/*iTEDA PE */ 
int major; *E ES 
int minor start; 人 # 起 始 次 设备 号 并 
unsigned int num; ”/* 分 配 的 设备 个 数 */ 


shorttype; [*tty driver 主 类 型 */ 
shortsubtype; [*tty driver 子 类 型 */ 
struct ktermios init termios; /# 初 始 termios*/ 
unsigned long flags; PII 
struct proc dir entry *proc entry; /* /proc 文件 系统 路 径 */ 
struct tty driver *other; /*PTY driver 专用 */ 
struct tty struct **ttys; 
struct tty port **ports; /tty 端口 
struct ktermios **termios; 
void *driver state; 
const struct tty operations *ops; IFTE RZ 
structlist head tty. drivers; 
h 
Linux 内 核实 现 的 TTY 驱动 程序 包含 如 下 几 种 主 类 型 ， 
#define TTY DRIVER TYPE SYSTEM 0x0001 
"define TTY DRIVER TYPE CONSOLE 0x0002// 控 制 台 
#define TTY DRIVER TYPE SERIAL 0x0003// 串 口 
#define TTY DRIVER TYPE PTY 0x0004 
#define TTY DRIVER. TYPE SCC 0x0005/*SCC 驱动 */ 
#define TTY DRIVER TYPE SYSCONS 0x0006 
每 种 TTY 主 类 型 下 面 有 各 自 的 子 类 型 。 
TTY 驱动 程序 的 操作 接口 用 tty. operations 结构 描述 : 


190 


struct tty operations { 
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struct tty struct * (*lookup)(struct tty driver *driver,struct inode *inode, int 1dx); 
int (*install)(struct tty driver *driver, struct tty struct *tty); 

void (*remove)(struct tty driver *driver, struct tty struct *tty); 

int (*open)(struct tty struct * tty, struct file * filp); 

void (*close)(struct tty struct * tty, struct file * filp); 

void (*shutdown)(struct tty struct *tty); 

void (*cleanup)(struct tty struct *tty); 

int (*write)(struct tty struct * tty,const unsigned char *buf, int count); 
int (*put char)(struct tty struct *tty, unsigned char ch); 

void (*flush chars)(struct tty struct *tty); 

int (*write room)(struct tty struct *tty); 

int (*chars in buffer)(struct tty struct *tty); 

int (*ioctl)(struct tty struct *tty;unsigned int cmd, unsigned long arg); 
long (*compat ioctl)(struct tty struct *tty;unsigned int cmd, unsigned long arg); 
void (*set termios)(struct tty struct *tty, struct ktermios * old); 

void (*throttle)(struct tty struct * tty); 

void (*unthrottle)(struct tty struct * tty); 

void (*stop)(struct tty struct *tty); 

void (*start)(struct tty struct *tty); 

void (*hangup)(struct tty struct *tty); 

int (*break ctl)(struct tty struct *tty, int state); 

void (*flush buffer)(struct tty struct *tty); 

void (*set ldisc)(struct tty struct *tty); 

void (*wait until sent)(struct tty struct *tty, int timeout); 

void (*send xchar)(struct tty struct *tty, char ch); 

int (*tiocmget)(struct tty struct *tty); 

int (*tiocmset)(struct tty struct *tty;unsigned int set, unsigned int clear); 
int (*resize)(struct tty struct *tty, struct winsize *ws); 

int (*set termiox)(struct tty struct *tty, struct termiox *tnew); 

int (*get icount)(struct tty struct *tty,struct serial icounter struct *icount); 
const struct file operations *proc fops; 


je 
内 核 使 用 tty set operations 函数 来 设置 tty. driver 的 操作 函数 接口 : 


void tty set operations(struct tty driver *driver,const struct tty operations *op); 


注册 一 个 TTY 驱动 使 用 tty register driver 函数 : 


inttty register driver(struct tty driver *driver); 


Linux 内 核 已 经 实现 TTY 核心 屋 ， 编 写 TTY 驱动 主要 是 实现 tty. operations. 
一 个 TTY 设备 可 以 有 一 个 或 多 个 端口 ， 端 口 用 tty_port 结构 描述 。 每 个 TTY 端口 对 应 
于 /dev 目录 下 一 个 设备 节点 。 


struct tty port { 
structtty bufhead buf,  /*1 Bx 
struct tty struct *tty; 
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下 面 


例 8.1 定制 printk 函数 
代码 见 \samples\8tty\8-l1myprint。 纪 


inttty insert flip char(structtty port *port,unsigned char ch, char flag);// 插 入 单个 
inttty insert flip string(struct tty port *port,const unsigned char "chars, size t size);//jf 


struct tty struct 
const struct tty port operations *ops; 


unsigned long 
unsigned char 


Struct mutex 
Struct mutex 
unsigned char 
unsigned int 
unsigned int 
struct kref 
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"itty; 


flags; 
console:1, 

low latency:1; 
mutex; 

buf mutex; 
*xmit buf, 
close delay; 
closing wait; 
kref; 


static vold my print(char *str) 


1 


j 


structtty struct *my tty; 
my tty = current-^signal-^tty; 


if (my tty != NULL) 


1 


[>m EM E / 


ATTY 标记 ASY */ 
[*3ij 138 15 console*/ 


PI GEXS SCRES/ 
[* FH Fg Be 
PEREAT) OUS 
[n] doge 


[385 H B] GER / 
PF BIS RET TRIS 


/# 引 用 计数 %/ 


K 动 层 参 考 代 码 如 下 : 


((my. tty-^driver)-^ops-—write) (my. tty,str,strlen(str)); 
((my. tty-7driver)-^ops-write) (my. tty,".....n",7); 


static int init my print init(void) 


1 


j 


my print("my print init!"); 


return 0; 


static void _ exit my print exit(void) 


1 


j 


my print("my print exit!"); 


运行 结果 如 下 : 
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[root@urbetter /homel# insmod myprint.ko 


psi 


两 个 函数 将 TT Y. 设备 驱动 接收 到 的 数据 放 入 TTY RI: 


/获取 当前 进程 的 tty 结构 


D E 


SERRE 


6 入 多 个 字符 
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82.5 TTY 数据 链 路 分 析 
TTY 设备 打开 函数 tty open 会 创建 一 个 tty struct 结构 ， 并 调用 tty add. file 函数 将 该 结 
构 与 打开 的 文件 (struct file) 绑 定 。tty struct 是 TTY 驱动 各 层 的 纽带 ， 下 面 是 其 主要 成 员 : 


struct tty_struct { 
struct tty_driver *driver; 
const struct tty_operations *ops; 
struct tty_ldisc *ldisc; 
struct tty_port *port; 

B 

下 面 以 TTY 数据 发 送 为 例 说 明 TTY 数据 链 路 。 根 据 上 面 的 分 析 ，TTY 数据 从 应 用 层 到 
达 内 核 层 ， 首 先 经 过 TTY 文件 层 : 


static ssize ttty write(struct file *file, const char _ user *buf,size_t count, loff t *ppos) 
1 
structtty struct *tty = file tty(file);/ 获 取 tty 结构 
struct tty ldisc *1d; 


ssize tret; 


ld-tty ldisc ref wait(tty); 
让 (!1d->ops->write)// 没 有 实现 线路 规程 会 返回 错误 
ret = -EIO; 
else 
ret = do tty write(Id-»ops-»write, tty, file, buf, count);// 调 用 线路 规程 层 函 数 


} 
tty write 函数 调用 了 线路 规程 层 的 函数 。 默 认 的 线路 规程 层 写 处 理 函 数 如 下 : 


static ssize tn tty write(struct tty struct *tty, struct file *file,const unsigned char *buf, size t nr) 
1 

const unsigned char *b — buf; 

if(O OPOST(tty)) { 


} else ( 
while (nr > 0) { 
mutex lock(&ldata-^output lock); 
€ = tty->ops->write(tty, b, nr);// 调 用 tty 驱动 的 write 函数 
mutex unlock(&ldata-^output lock); 
if(c « 0) ( 
retval = c; 
goto break_out; 
} 
if (!c)break; 
DELLI: 
nr -= C; 
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j 


可 见 TTY 数据 一 路 经 历 了 TTY 文件 层 、TTY 线路 规程 层 到 TTY 
到 总 线 上 。 


8.3 串口 驱动 层 


8.3.1 uart driver 


串口 驱动 是 一 种 TTY 驱动 ， 是 对 所 有 
口 驱 动 : 


Tn 
pun 


struct uart driver ( 
struct module *owner; 


const char *driver name; 
const char *dev name; 

int major;// 主 设备 号 
int minor/ 次 设备 号 
int nr — /端口 数 
struct console*cons; /终端 
/私有 数据 ， 初 始 化 为 NULL 

struct uart state *state; 


Structtty driver — *tty driver; 


is 


口 设备 驱动 会 注册 成 串口 驱动 ， 注 册 函 数 为 uart register driver: 


Ud 


Tn 


int uart register driver(struct uart driver *drv) 
{ 
struct tty_driver *normal; 
int i, retval; 
BUG_ON(drv->state);// 假 如 state 不 为 NULL， 则 打印 错误 信息 
/分 配 state 内 存 
drv->state = kzalloc(sizeof(struct uart state) * drv-^nr, GFP KERNEL) 
if (!drv-^state) 
goto out; 
/分 配 tty 驱动 结构 


normal = alloc tty driver(drv-^nr); 


if (!Inormal) 
goto out kfree; 
/填充 normal 
drv-^tty driver = normal; 
normal-^»driver name = drv->driver name; 


normal--name = drv-^»dev name; 
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设备 驱动 的 抽象 。uart_driver 结构 代表 一 个 


9 


驱动 层 ， 最 后 被 发 送 


Ud 
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normal->major = drv->major; 

normal->minor start = drv->minor; 

normal->type -TTY DRIVER TYPE SERIAL;// 串 口 类 型 
normal->subtype = SERIAL TYPE NORMAL; 


normal-^init termios- tty std termios; 
normal->init termios.c cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL; 
normal->init termios.c ispeed = normal-^init termios.c ospeed = 9600; 
normal-»flags = TTY DRIVER. REAL RAW|TTY DRIVER DYNAMIC DEV/ 动态 设备 
normal--driver state = drv; 
tty set operations(normal, &uart ops);/ 设 置 串 口 设 备 的 tty operations 
/初始 化 好 端 
for (i = 0; i < drv->nr i) { 
struct uart state *state = drv->state + 1; 
struct tty port *port = &state-port; 
tty port init(port); 
port-^ops = &uart port ops; 


j 
/注册 tty 驱动 
retval = tty register driver(normal); 
if (retval >= 0) 
return retval; 
/注册 失败 后 续 处 理 
for (i = 0; i < drv->nr; i++) 
tty port destroy(&drv-»state[i].port); 
put tty driver(normal); 


out kfree: 


out: 


kfree(drv-^state); 


return-ENOMEM; 


8.3.2 uart port 


—^H 


H 
H 


串口 ) 这 些 串 


uart port 用 于 


控制 器 或 串口 芯片 上 往往 有 多 个 串 行 端口 〈serial ports， 对 应 于 一 个 物理 上 的 

行 端口 具备 相同 的 操作 机 制 。 内 核 中 将 这 些 串 行 端口 用 uart_port 结构 描述 。 

日 述 一 个 UART 端口 的 中 断 、IO 内 存 地 址 、FIFO 大 小 、 端 口 类 型 等 信息 : 
struct uart port { 

spinlock t lock; /*8i*/ 

unsigned long iobase; /*IO 基地 址 */ 

unsigned char _ iomem *membase; 。” 旋 内 存 地 址 */ 

unsigned int (*serial in)(struct uart port *, int); 

void (*serial out)(struct uart port *, int, int); 

void (*set termios)(struct uart port *,struct ktermios *new,truct ktermios *old); 

void (*set mctrl)(struct uart port *, unsigned int); 

int (*startup)(struct uart port *port); 
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void (*shutdown)(struct uart port *port); 

void (*throttle)(struct uart port *port); 

void (*unthrottle)(struct uart port *port); 

int (*handle irq)(struct uart port *); 

void (*pm)(struct uart port *, unsigned int state,unsigned int old); 
void (*handle break)(struct uart port *); 

int (*rs485 config)(struct uart port *,struct serial rs485 *rs485); 
unsigned int irg; [FB 

unsigned long irgflags; PEPPER zs] 

unsigned int uartclk; /* tep 

unsigned int fifosize; FRIZ fifo 大 小 */ 

unsigned char x char; /*xon/xoff 握手 字 节 */ 
unsigned char regshift; PESE RR ARES 

unsigned char iotype; /*IO 访问 类 型 */ 

unsigned char unused]; 

unsigned int read status mask; PERAE 
unsigned int ignore status mask; ”/* 忽 略 状 态 掩 码 */ 
struct uart state *state; /指向 父 设备 的 state*/ 
structuart icount ^ icount; egy) 

struct console *cons; /* 控 制 台 */ 
放下 面 的 标志 在 获得 mutex 后 才能 更 新 */ 

upf t flags; 

upstat t status; 

int hw stopped; 

unsigned int mctrl; 诺 当 前 modem ctrl 设置 */ 
unsigned int timeout; 让 字符 为 单元 的 超时 */ 
unsigned int type; 3 OA, 

const struct uart ops "ops; 

unsigned int custom divisor; 

unsigned int line; f O ZU 

unsigned int minor; 

resource size t mapbase; [* Py TERES 

resource size t mapsize; [* VE BURN A NJ 
struct device *dev; PSOE 

unsigned char hub6; /[*8250 驱动 专用 */ 
unsigned char suspended; 

unsigned char irq wake; 

unsigned char unused[2]; 

struct attribute group *attr group; Peg H JS THE / 

const struct attribute group **tty groups;  /*tty 属性 */ 

struct serial rs485 rs485; 

void *private data; FESAT 


j 
Xr y ORERE ERZ F: 


int uart add one port(struct uart_driver *drv, struct uart port *porb/ 添 加 一 个 端口 
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int uart remove one port(struct uart driver *drv, struct uart port *porbVW 移 除 一 个 端口 


X 


int uart match port(struct uart port *portl, struct uart port *port2)/ 比 较 两 个 端 


an 


intuart suspend port(struct uart driver *drv, struct uart port *porb/ 和 暂停 端口 
int uart resume port(struct uart driver *drv, struct uart port *porbV 恢 复 端口 


口 设备 的 文件 操作 最 终 转 化 为 串 行 端口 的 操作 接口 (uart_ops 结构 ): 


ei 


nm 


struct uart ops { 
unsigned int (*tx empty)(struct uart port *); 


void (*set mctrl)(struct uart port *, unsigned int mctrl); 
unsigned int (*get mctrl)(struct uart port *); 

void (*stop tx)(struct uart port *); /停止 传输 
void (*start tx)(struct uart port *); /开始 传输 
void (*throttle)(struct uart port *); 

void (*unthrottle)(struct uart port *); 

void (*send xchar)(struct uart port *, char chm; 发送 字符 
void (*stop rx)(struct uart port *); /停止 接收 
void (*enable ms)(struct uart port *); 

void (*break ctl)(struct uart port *, int ctl); 

int (*startup)(struct uart port *); 

void (*shutdown)(struct uart port *); 

void (*flush buffer)(struct uart port *); 

void (*set termios)(struct uart port *, struct ktermios *new,struct ktermios *old); 
void (*set ldisc)(struct uart port *, struct ktermios *); 

void (*pm)(struct uart port *, unsigned int state,unsigned int oldstate); 
const char *(*type)(struct uart port *); /返回 端口 类 型 
void (*release port)(struct uart port *); /释放 端口 

int (*request port)(struct uart port *); 

void (*config port)(struct uart port *, int); /配置 端口 

int (*verify port)(struct uart port *, struct serial struct *); 
int (*ioctl)(struct uart port *, unsigned int, unsigned long); 


8.4 S3C6410X 串口 设备 驱动 程序 


编写 串口 驱动 程序 的 重点 在 于 实现 串 行 端口 的 操作 函数 (struct uart ops)。 三 星 的 
S3C24xx 系列 与 S3C64xx 系列 的 串口 驱动 程序 是 统一 的 ， 代 码 参 见 /drivers/tty/serial/ 
samsung.c。 串 口 驱动 程序 入 口 代码 如 下 : 


static struct platform driver samsung serial driver = { 


.probe = s3c24xx serial probe, 
remove = s3c24xx serial remove, 
d table = s3c24xx serial driver ids, 
.driver ={ 

.name = "samsung-uart", 


pm =SERIAL SAMSUNG PM OPS, 
197 


Linux 驱动 程序 开发 实例 第 2 版 


.of match table — of match ptr(s3c24xx uart dt match), 
h 
5h 
/平台 入 口 
module platform driver(samsung serial driver); 


s3c24xx serial probe 串口 探测 函数 如 下 : 


static int probe_index; 
static struct uart driver s3c24xx uart drv= { 


.owner = THIS MODULE, 
.driver name = "s3c2410 serial", 
nr = CONFIG SERIAL SAMSUNG UARTS, 
.cons =S3C24XX SERIAL CONSOLE, 
.dev name = S3C24XX SERIAL NAME, 
major = S3C24XX SERIAL MAJOR, 
minor = S3C24XX SERIAL MINOR, 
h 
static int s3c24xx serial probe(struct platform device *pdev) 
1 


struct device node *np = pdev-^dev.of node; 
struct s3c24xx uart port *ourport; 
int index = probe index; 
int ret; 
if (np) { 

ret — of alias get id(np, "serial"); 

if (ret >= O)index = ret; 
j 
dbg("s3c24xx serial probe(Vop) %d\n", pdev, index); 
ourport — &s3c24xx serial ports[index]; 
ourport-^drv data = s3c24xx get driver data(pdev); 
if (ourport-^drv data) { 

dev err(&pdev-»dev, "could not find driver data"); 

return -ENODEV; 
j 
ourport-^baudclk = ERR. PTR(-EINVAL); 
ourport--info = ourport-^»drv data->info; 
ourport-^cfg = (dev get platdata(&pdev-^dev)) ? 

dev get platdata(&pdev-^dev) :ourport-^drv data->def cfg; 

if(np)of property read u32(np,"samsung,uart-fifosize", &ourport-^port.fifosize); 
if (ourport-^drv data-»fifosize[index ]) 

ourport-^port.fifosize = ourport-^»drv data->fifosize[index]; 
else if (ourport-^info-fifosize) 

ourport-^port.fifosize = ourport->info->fifosize; 
UDMA 大 小 必须 与 cache 尺寸 对 齐 
ourport-^min dma size = max t(int, ourport->port.fifosize,dma get cache alignment()); 
probe index; 
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dbg("%s: initialising port %p...\n", _func__, ourport); 
/初始 化 端口 
ret = s3c24xx serial init port(ourport, pdev); 
if (ret < 0) 

return ret; 

/多 个 串 行 端口 共享 一 个 串口 驱动 ， 注 册 过 就 不 再 注册 

if(!s3c24xx uart drv.state) { 

ret — uart register driver(&s3c24xx uart drv); 

if (ret < 0) { 

pr err("Failed to register Samsung UART driver"); 


return ret; 


} 
dbg("%s: adding portn", func ); 
uart add one port(&s3c24xx uart drv, &ourport->port);// 添 加 端口 
platform set drvdata(pdev, &ourport->port); 
clk disable unprepare(ourport->clk); 
tet= s3c24xx serial cpufreq register(ourport);// 申 请 接收 CPU 频率 调整 通知 
if (ret < 0) 
dev err(&pdev-»dev, "failed to add cpufreq notifier n"); 
return 0; 


j 


s3c24xx serial probe 函数 调用 uart add one port 函数 注册 了 一 个 串 行 端口 设备 。 下 面 是 
三 星 ARM 处 理 器 的 串口 操作 冰 数 设置 ; 


pun 


static struct uart ops s3c24xx serial ops = { 


.pm = s3c24xx serial pm, 

‘tx empty | -—s3c24xx serial tx empty, 
.get mctrl = s3c24xx serial get mctrl, 
.Set mctrl = s3c24xx serial set mctrl, 
Stop tx = s3c24xx serial stop tx, 
.Start tx — s3c24xx serial start tx, 
.Stop rx = s3c24xx serial stop rx, 
.break ctl = s3c24xx serial break ctl, 
.Startup — s3c24xx serial startup, 
.Shutdown = s3c24xx serial shutdown, 


.Set termios = s3c24xx serial set termios, 
type = s3c24xx serial type, 

release port = s3c24xx serial release port, 
request port = s3c24xx serial request port, 
.config port = s3c24xx serial config port, 
.Verify port = s3c24xx serial verify port, 


n 
#define PORT LOCK UNLOCKED(1) 
. SPIN LOCK UNLOCKED(s3c24xx serial ports[i].port.lock) 
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static struct s3c24xx uart port s3c24xx serial ports[CONEIG SERIAL SAMSUNG UARTS]={ 


[0] 4 
.port — 1 
lock = PORT LOCK UNLOCKEDY(0), 
Jotype = UPIO MEM, 
.uartclk = 0, 
.fifosize — 16, 
.0ps = 必 S3c24xx serial ops, 
.flags = UPF BOOT AUTOCONF, 
ine = 0, 
} 
h 


Js 


s3c24xx serial startup 函数 中 申请 了 日 


断 ， 发 送 中 断 与 接收 中 断 分 开 处 理 。 


pm 


static int s3c24xx serial startup(struct uart port *port) 
1 
struct s3c24xx uart port *ourport — to ourport(port); 
int ret; 
dbg("s3c24xx serial startup: port=%p (96081Ix, op)", 
port, (unsigned long long)port-^mapbase, port-^membase); 
rx enabled(port) = 1; 
I Fi Belice er 
ret = request irq(ourport-^rx irq, s3c24xx serial rx chars, 0,53c24xx serial portname(port), ourport); 
if (ret != 0) ( 
dev err(port-^dev, "cannot get irq %d\n", ourport-^rx ir); 


return ret; 
j 
ourport-^rx claimed = 1; 
dbg("requesting tx irq...n"); 
tx enabled(port) = 1; 
/申请 发 送 中 晰 
ret = request irq(ourport-^tx irq, s3c24xx serial tx chars, 0,s3c24xx serial portname(port), ourport); 
if (ret) { 
dev err(port-^dev, "cannot get irq %d\n", ourport-^tx irq); 


goto err; 
} 
ourport-^tx claimed = 1; 
dbg("s3c24xx serial startup ok n"); 
return ret; 
err: 
s3c24xx serial shutdown(port); 


return ret; 


口 读 写 的 底层 函数 为 s3c24xx serial rx chars 和 s3c24xx serial tx chars， 有 兴趣 的 读 


nmn 
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者 可 以 继续 阅读 内 核 代 码 ， 不 再 歼 述 。 


8.5 TTY 应 用 层 


TTY 设备 的 访问 同文 件 的 访问 类 似 ， 不 同 的 是 TTY 设备 的 操作 模式 的 设置 比 一 般 文 从 
烦琐 。 访 问 TTY 设备 需要 包含 termios.h 头 文件 。 最 基本 的 TTY 设备 设置 包括 波 特 率 设置 、 
校 验 位 和 停止 位 设置 。termios 结构 描述 TTY 设备 的 操作 模式 : 


T 


struct termios 


{ unsigned short c iflag; [Pf AN B Sb */ 
unsigned short c oflag; Py ER */ 
unsigned short c cflag; PESE pis */ 
unsigned short c lflag; 诺 内 部 模式 标志 */ 
unsigned char c line; 此 线路 规则 */ 
unsigned char c_cc[NCC]; /控制 字符 头 
h 
下 面 以 串口 为 例 讲解 TTY 设备 的 基本 访问 步 又。 
(D 打开 串口 
在 Linux. 下 串口 文件 是 位 于 /dev 下 的 。 串 口 一 为 /dewttyS0， 串 口 二 为 /devttyS1。 打 开 串 


口 可 使 用 标准 的 文件 打开 函数 操作 : 


int fd; 

PEE AE STAT R DU 

fd = open( "/dev/ttySO", O_RDWR); 
if -1 = fd)( 

PANBSETTJERR H ECC 

perror(" 提示 错误 ! "); 

} 


(2) 设置 串口 
串口 设置 相关 的 操作 函数 如 下 : 


PODIUM HB Ben 

speed t cfgetospeed (struct termios *termios p); 
POROBURLN SUBE SENI 

speed t cfgetispeed (struct termios *termios p); 

PE EE E 

int cfsetospeed (struct termios *termios p, speed t speed) ; 
PHSCELRBLN BOSSES 

int cfsetispeed (struct termios *termios p, speed t speed) ; 
入 获取 串口 设置 六 

int tcgetattr (int fd, struct termios *termios p); 

虚设 置 串 口 设置 */ 

int tcsetattr (int fd, int optional actions, struct termios *termios p); 


修改 波 特 率 的 实例 代码 : 
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struct termios Opt; 

tcgetattr(fd, &Opt); 

cfsetispeed(&Opt,B19200); ERAN y 19200Bps*/ 
cfsetospeed(&Opt,B 19200); lA ERA 19200Bps*/ 
tcsetattr(fd, TCANOW,&Opt); 


设置 校 验 位 和 停止 位 的 实例 : 


struct termios options; 

tcgetattr(fd, &Opt); 

options.c cflag &- 一 CSIZE; 

Option.c cflag |= —CSS8; /数据 位 为 8 
options.c_cflag &= 一 CSTOPB; /停止 位 
Option.c cflag &= —PARENB; 

Option. cflag|- —PARODD;  // 偶 校 验 
tcsetattr(fd| TCANOW,& options); 


需要 注意 的 是 ， 如 果 不 是 开发 终端 类 型 的 应 用 程序 ， 只 是 使 用 
该 使 用 原始 模式 (Raw Mode) 方 式 来 进行 通信 ， 设 置 方式 如 下 : 


nm 


口 来 传输 数据 ， 那 么 应 


options.c lflag &= ~(ICANON | ECHO | ECHOE |ISIG)，/* 输 入 */ 
options.c oflag &- 一 OPOST ，/* 输 出 */ 


(3) 读 写 串口 
设置 好 串口 之 后 ， 读 写 串 口 就 很 容易 了 ， 只 需 把 串口 当 作文 件 读 写 即 可 。 
D 发 送 数据 


char buffer[1024]; 
int Length; 


int nByte; 
nByte — write(fd, buffer ,Length) 


2) 读 取 串口 数据 
使 用 文件 操作 read 函数 读 取 ， 如 果 设 置 为 原始 模式 (Raw Mode) 传 输 数 据 ， 那 么 read K 
数 返 回 的 字符 数 是 实际 串口 收 到 的 字符 数 。 也 可 以 使 用 操作 文件 的 函数 来 实现 异步 读 取 ， 如 


fcntl 或 select 等 。 


char buff[1024]; 
int Len; 
int readByte = read(fd,buff,Len); 


(D 关闭 串口 


close(fd); 
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Framebuffer 驱动 程序 是 Linux 内 核 中 显示 设备 驱动 程序 的 标准 。 目 前 大 多 数 Linux 界面 
系统 都 支持 Framebuffer 驱动 程序 。 本 章 重 点 介绍 Framebuffer 驱动 程序 的 框架 与 开发 方法 ， 
以 及 界面 系统 的 架构 。 


9.1 Linux Framebuffer 驱动 程序 原理 


Framebuffer 即 帧 缓存 。 内 核 将 显示 缓存 映射 (mmap) 到 用 户 地 址 ， 应 用 层 操作 该 用 户 
地 址 ， 内 容 直 接 映射 到 显示 物理 地 址 。 图 9-1 为 Linux Framebuffer 驱动 原理 图 。 


应 用 层 l 


LCD 驱 动 器 + 屏 


图 9-1 Linux Framebuffer 驱动 原理 


9.1.1 Framebuffer 核心 数据 结构 


Framebuffer 设备 是 一 种 字符 设备 ， 使 用 主 设 备 号 29， 次 设备 号 用 于 帧 缓冲 设备 之 间 的 
K4. Framebuffer 驱动 程序 的 设备 文件 一 般 是 /dewfb0~fbn。 假 设 显示 模式 是 1024X768 像 
素 的 分 辨 率 ，8 位 色 模 式 ， 可 以 通过 如 下 的 命令 清空 屏幕 显示 : 


# dd if=/dev/zero of=/dev/fb0 bs=1024 count-768 
framebuffer 驱动 程序 的 核心 数据 结构 是 fo_info， 定 义 如 下 : 


struct fb info { 


atomic t count; 


int node; 

int flags; 

struct mutex lock; [B FESBEUS 

struct mutex mm lock; /*fb mmap and smem * 的 锁 */ 
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struct fb var screeninfo var; /* 可 变 屏幕 参数 */ 


struct fb. fix screeninfo fix; 此 固定 屏 幕 参 数 */ 
struct fb monspecs monspecs; /* ERE Vo zs s AUS 
struct work struct queue; /*Framebuffer 事件 队列 */ 
struct fb. pixmap pixmap; /* E E pg en 

struct fb. pixmap sprite; [AJARI e */ 

struct fb. cmap cmap; [**^8f cmap*/ 

structlist head modelist; IRINIK */ 

struct fb. videomode *mode; /* ARTERI */ 


#ifdef CONFIG FB BACKLIGHT 


struct backlight device *bl dev; /背光 设备 


struct mutex bl curve mutex; 


"HG 


ELS Fe 


u8 bl curve[FB BACKLIGHT LEVELS]; 


#endif 
struct fb. ops *fbops; 
struct device *device; 
struct device *dev;/*fb 设备 */ 
/私有 sysfs 


int class flag; 


/framebuffer 操作 函数 
[Se CRI 


标志 */ 


#ifdef CONFIG FB_TILEBLITTING 


struct fb tile ops *tileops; 
#endif 
union { 
char ; 
char *screen buffer; 
fie 
unsigned long screen size; 
void *pseudo palette; 
u32 state; fii p 
void *fbcon par; 
FEL PIE VERAS 


void *par; 


struct apertures struct { 
unsigned int count; 
struct aperture { 


iomem *screen base; 


状态 如 挂 
/*fbcon 使 用 的 私有 数据 */ 


/* E 


块 操作 */ 


此 虚拟 地 址 */ 


IS VRAM 大 小 */ 
/*16 色 假 彩色 表 */ 
起 等 */ 


resource size t base; 


resource size t size; 


} ranges[0]; 
} *apertures; 
bool skip vt switch; 
h 


fb var screeninfo 


由 应 用 程序 动态 改变 。 成 员 变 量 


xres virtual 和 yres_virtual 是 虚拟 分 辩 率 ， 


结构 定义 了 视频 硬件 一 些 可 变 的 特性 
xres 和 yres 定义 在 显示 屏 上 


。 这 些 特性 在 程 


实 显示 


它们 定义 的 是 显存 分 


2 


400， 而 虚拟 分 
行 。 这 就 需 
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) 状 率 是 800， 意 味 着 
要 另外 一 个 成 员 变 量 


al 


在 显存 中 存储 着 
yoffset 来 决定 到 底 显 示 


800 行 显 示 行 ， 但 是 


每 次 


HET 


。 当 yoffset=0 


序 运 行 
的 分 


O $k 


时 , 


期 间 可 以 


XXE. qf 
And x LM E 


和 从 用 显示 400 


从 显存 0 
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行 开始 显示 400 ÍF, WMR yoffset 二 30， 就 从 显存 30 行 开始 显示 400 1T. fb var screeninfo Zi 
构 定 义 如 下 : 


= 


struct fb. var screeninfo { 
. u32 xres; /*n[ 34) ES S/ 
. U32 yres; 


. u32xres virtual; PF Ke UL) ERES 


. u32yres virtual; 


. u32 xoffset; fF Je S Rp WC BA) X i / 
. u32 yoffset; /# 从 虚拟 到 可 见 区 的 Y 偏 移 */ 
_uU32 bits_per pixel;/#* 每 像素 的 比特 交 


. u32 grayscale; /*!=0 表示 灰 度 图 */ 


struct fb_bitfield red; 
struct fb. bitfield green; 
struct fb. bitfield blue; 


struct fb bitfield transp; [F8 WI RES / 


. u32 nonstd; [*1— 0 非 标 准 像素 格式 */ 
. u32activate;/*FB ACTIVATE * 标 志 */ 
. u32 height; ABRE (mm) */ 
_ u32 width; 人 #* 图 像 宽度 (mm) */ 


. u32accel flags; 


. u32 pixclock; /* 像 素 时 钟 (pico seconds)*/ 
. u32left margin; P575 I] foi RRT Ep, 


. u32right margin;/* 图 像 到 


同步 信号 的 时 钟 数 */ 


. u32 upper margin; /* 帧 同步 信号 到 图 像 的 时 钟 数 */ 


. u32lower margin; 


.. u32 hsync len; F*7K^E IRA BES/ 

. u32 vsync len; PF31 EC FRE RES / 

. u32 sync; [*FB SYNC * 标 志 */ 

. u32 vmode; /*FB VMODE * 开 头 的 标志 六 


. u32 rotate; /旋转 
. u32colorspace;/*FOURCC 
. u32 reserved[4];/* A B */ 

B 


* 


模式 的 颜色 空间 */ 


定 屏幕 参数 结构 fb. fix screeninfo 定义 如 下 : 


struct fb. fix screeninfo { 
char id[16];/* facil E E */ 


unsigned long smem start; 


/*framebuffer 物理 地 址 起 点 */ 


. u32 smem len; /*framebuffer 物理 内 存 长 度 */ 
. u32type; /#* 类 型 ，FB TYPE 开头 */ 


. u32type aux; 


. vu32 visual; /# 视 频 模 式 ，FB VISUAL 开头 */ 


. ul6 xpanstep; 
. ul6 ypanstep; 
. ul6 ywrapstep; 
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. u32line length; /* 行 字 节 数 */ 

unsigned long mmio start;/*I/O 映射 内 存 起 点 */ 
. u32 mmio len; /*]/O 映射 内 存 长 度 */ 

. U32 accel; 

. ul6 capabilities/* Jl, FB CAP. * 宏 定义 */ 

. ul6 reserved[2]; UR Fd */ 


h 
register framebuffer 函数 用 来 注册 一 个 Framebuffer 驱动 ， unregister framebuffer 函数 用 来 
注销 一 个 Framebuffer 驱动 ， 两 者 原型 如 下 : 


intregister framebuffer(struct fb info *fb info); // 注 册 
int unregister framebuffer(struct fb info *fb info); /注销 


9.1.2 Framebuffer 操作 接口 


fb info 结构 中 的 一 个 重要 成 员 是 fo. ops 结构 ， 它 是 开发 Framebuffer 驱动 程序 的 核心 结 
构 ， 定 义 如 下 : 


struct fb ops { 
struct module *owner; 
int (*fb open)(struct fb. info *info, int user);/1] JT 
int (*fb release)(struct fb. info *info, int user);// 释 放 
/下 面 两 个 是 为 不 支持 mmap 的 设备 提供 的 读 写 接 


ssize t(*fb read)(struct fb info *info, char — user *buf;size t count, loff t *ppos); 


LI 


ssize t(*fb write)(struct fb info *info, const char — user *bufsize t count, loff t *ppos); 
int (*fb check var)(struct fb var screeninfo *var, struct fb. info *info);// 参 数 检 查 
int (*fb set par)(struct fb info *info);/ 参 数 设置 
int (*fb setcolreg)(unsigned regno, unsigned red, unsigned green, 

unsigned blue, unsigned transp, struct fb. info *info);//Uz EC ey fa 
int (*fb. setemap)(struct fb. cmap *cmap, struct fb. info *info);/ 设 置 色彩 映射 表 
int (*fb blank)(int blank, struct fb. info *info);/ 清 空 显 示 
int (*fb pan display)(struct fb var screeninfo *var, struct fb. info *info);// 游 动 显示 
void (*fb fillrect) (struct fb. info *info, const struct fb fillrect *recb;// 绘 制 矩形 
void (*fb copyarea) (struct fb info *info, const struct fb. copyarea *region);// 区 域 复 制 
void (*fb imageblit) (struct fb. info *info, const struct fb. image *image);/ 绘 制图 像 
int (*fb. cursor) (struct fb. info *info, struct fb. cursor *cursor);// 光 标 
void (*fb rotate)(struct fb. info *info, int angle); /* JEFE f 7jv*/ 
int (*fb sync)(struct fb info *info); 
int (*fb ioctl)(struct fb. info *info, unsigned int cmd;unsigned long arg);// 命 令 接 


int (*fb compat ioctl)(struct fb info *info, unsigned cmd,unsigned long arg);// 兼 容 性 命令 接 
int (*fb mmap)(struct fb. info *info, struct vm area. struct *vma);// 特 殊 映 射 接口 
void (*fb get caps)(struct fb info *info, struct fb blit caps *caps, 
struct fb var screeninfo *van;/ 获 取 驱 动能 
void (*fb destroy)(struct fb info *info); 
int (*fb debug enter)(struct fb. info *info); 
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int (*fb debug leave)(struct fb info *info); 


编写 帧 缓冲 驱动 程序 主要 就 是 编写 好 _ops 各 个 成 员 函 数 。 


9.1.3 Framebuffer 驱动 的 文件 接口 


Framebuffer 驱动 程序 集中 放置 在 内 核 的 /linux/drivers/video E 3€ Fo linux/drivers/video 


/fbmem.c 文件 提供 了 Framebuffer 设备 的 通用 文件 操作 接口 ， 自 定义 的 Framebuffer 驱动 程序 
可 以 使 用 fomem.c 中 提供 的 默认 文件 接口 ， 该 接口 定义 如 下 : 


static const struct file operations fb fops = { 
.owner = THIS MODULE, 
read — fb read, 
.Write = fb write, 
unlocked ioctl = fb ioctl, 
.mmap = fb mmap, 
open = fb open, 
release — fb release, 
.llseek = default llseek, 
je 
static int — init fbmem init(void) 
{ 
proc create("fb", 0, NULL, &fb proc fops); 
if (register chrdev(FB MAJOR,"fb",&fb fops)) 
printk("unable to get major %d for fb devs\n", FB MAJOR); 
fb class = class create(THIS MODULE, "graphics"); 
if(IS ERR(fb class)) { 
printk(KERN WARNING "Unable to create fb class; errno = old", PTR ERR(fb class)); 
fb class - NULL; 
j 
return 0; 


) 
用 户 通过 内 存 映射 mmap 函数 将 显示 缓存 映射 到 进程 地 址 空间 之 后 ， 就 可 以 直接 进行 读 
写 操作 ， 且 写 操作 可 以 立即 反映 在 屏幕 上 。 新 注册 的 Framebuffer 驱动 会 自动 创建 以 
FB MAJOR 为 主 设备 号 的 /dewfbn 节点 。 


int register framebuffer(struct fb info *fb info) 


1 
int ret; 
mutex lock(&registration lock); 
ret = do register framebuffer(fb info); 
mutex unlock(&registration lock); 
return ret; 

j 


static int do register framebuffer(struct fb info *fb info) 
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fb info->dev = device create(fb class, fb info->deviceMKDEV(EB MAJOR, i), NULL, "fb%d", i); 


} 
下 面 是 Framebuffer 设备 的 mmap 接口 的 实现 : 


static int fb _ mmap(struct file *file, struct vm area struct * vma) 
1 
struct fb info *info = file fb info(file); 
struct fb. ops *fb; 
unsigned long mmio pgoff; 
unsigned long start; 
u32 len; 
if ('info)return -ENODEV; 
fb = info-^fbops; 
if (!fb)return -ENODEV; 
mutex lock(&info-^mm lock); 
if (fb->fb mmap) { 
int res; 
res = fb-^fb mmap(info, vma); 
mutex unlock(&info-mm lock); 
return res; 
j 
start = info-^fix.smem start; 
len = info-^fix.smem len; 
mmio pgoff = PAGE ALIGN((start & -PAGE MASK) + len) >> PAGE SHIFT; 
if (vma->vm pgoff >= mmio pgoff) { 
if (info->var.accel flags) { 
mutex_unlock(&info->mm lock); 
return -EIN VAL; 
j 
vma->vm pgoff -= mmio pgoff; 
start = info->fix.mmio_ start; 
len = info->fix.mmio_len; 
j 
mutex unlock(&info-mm lock); 
vma->vm page prot- vm get page prot(vma-^vm flags); 
fb pgprotect(file, vma, start); 
return vm iomap memory(vma, start, len); 


} 


vm iomap memory 函数 调用 remap pfn range 函数 来 实现 物理 地 址 到 用 户 地 址 的 映射 。 
fb mmap 函数 将 info->fix.smem start 开始 的 info->fix.smem len 字 节 的 地 址 空间 映射 到 用 户 
空间 。 在 设计 framebuffer 驱动 时 ， 要 设置 好 smem start 与 smem len 参数 。 


N 
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9.1.4 Framebuffer 驱动 框架 代码 分 析 


在 Linux 内 核 引 


区 动 程 序 代码 下 有 一 个 skeletonfb.c 文件 
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， 它 演示 了 开发 Framebuffer 设备 


K 动 程序 的 基本 方法 。 下 面 分 析 这 个 文件 。 首 先 看 节 fix screeninfo 结构 : 
static struct fb fix screeninfo xxxfb fix = { 
id= "FB's name", 
.type = FB_TYPE_PACKED PIXELS, 
.Visual= | FB VISUAL PSEUDOCOLOR, 
.Xpanstep = 1, 
.ypanstep = 1, 
.ywrapstep = 1, 
.ccel - FB ACCEL NONE, 


is 


定义 一 个 全 局 的 fb info 结构 ， 这 个 结构 是 Framebuffer 驱动 程序 的 核心 。 


static struct fb. info info; 


接 下 来 定义 Framebuffer 驱动 程序 自己 的 文件 操作 接口 xxxfb_ops: 
static struct fb ops xxxfb ops- 1 
.owner = THIS MODULE, 
.fb. open — xxxfb open, 
.tb read — xxxfb read, 
.fb. write — xxxfb write, 
.fb release = xxxfb release, 
.fb check var =xxxfb check var, 
.fb set par — xxxfb set par, 
.tp setcolreg — xxxfb setcolreg, 
.fb blank — xxxfb blank, 
.fb pan display — xxxfb pan display, 
.fb fillrect = xxxfb fillrect, PF ds RARUS 
.fb copyarea — xxxfb copyarea, [eis EFL Z, 
.fb imageblit —xxxfb imageblit, PE ER CSI 
fb cursor  —xxxfb cursor, 诺 可 选 函 数 */ 
‘fb rotate = xxxfb rotate, 
.tb sync — xxxfb sync, 
.fb ioctl = xxxfb ioctl, 
.也 _ mmap =xxxfb mmap, 
h 
在 probe 函数 中 注册 Framebuffer 驱动 ， 代 人 码 如 下 : 


static int xxxfb probe(struct pci dev *dev, const struct pci device id *ent) 


1 
struct fb. info *info; 
struct xxx. par *par; 
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} 


struct device *device = &dev->dev; /*or &pdev->dev*/ 
int cmap len, retval; 
info = framebuffer alloc(sizeof(struct xxx. par), device); 
if ('info) { 

/*goto error path*/ 
j 
par = info->par; 
info->screen base = framebuffer virtual memory; 
info->fbops = &xxxfb ops; 


info->fix = xxxfb fix; 


En] 


色 板 设置 % 


info-»pseudo palette = pseudo palette; /* y 
info->flags - FBINFO DEFAULT; 
info-^pixmap.addr = kmalloc(PIXMAP SIZE, GFP KERNEL); 
if ('info-^pixmap.addr) { 


/*goto error*/ 
} 
info->pixmap.size = PIXMAP SIZE; 
info-^pixmap.flags = FB PIXMAP SYSTEM; 
info-»pixmap.scan align = 4; /扫描 字 节 对 齐 
info->pixmap.buf align = 4;// 绥 冲 字 节 对 齐 
info->pixmap.access align = 32;// 可 访问 字 节 对 齐 
if (Imode option) 
mode option = "640x480@60";/ 默 认 视 频 模式 

retval = fb find mode(&info->var info, mode option, NULL, 0, NULL, 8);// 查 找 视频 模式 
if (!retval || retval == 4) 

return -EINVAL; 
if(fb alloc cmap(&info-7cmap, cmap len, 0))// 分 配 映 射 表 

return -ENOMEM; 


info->var = xxxfb var; 


xxxfb check var(&info--var, info); 
/*xxxfb set par(info);*/ 
if (register framebuffer(info) < 0) {// 注 册 framebuffer 驱动 
fb dealloc cmap(&info-^»cmap); 
return -EINVAL; 
} 
fb info(info, "%s frame buffer device\n", info->fix.id); 
pei set drvdata(dev, info); /*or platform set drvdata(pdev, info)*/ 
return 0; 


由 于 篇 幅 原 因 ， 就 不 一 一 分 析 xxxfb. ops 中 的 函数 了 ， 读 者 可 以 参看 内 核 代 码 。 


9.2 S3C6410X 显示 控制 器 


S3C6410X 的 显示 控制 单元 可 以 将 图 像 数据 传送 给 外 部 的 LCD 驱动 接口 ， 图 像 数 
据 可 以 来 自 后 处 理 单元 的 内 部 总 线 或 系统 内 存 区 的 视频 缓存 。LCD 驱动 接口 可 以 是 以 下 
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四 种 : 

(1) 传统 的 RGB 接口 

(2) I80 接 

(3) NTSC/PAL 标准 TV 解码 器 

(4) IT-RBT.601 接口 

S3C6410X 的 显示 控制 单元 支持 5 AS EUSSAMEE D, BET ELSE n] AREA EN 
格式 、16 级 的 alpha 混 色 、x-y 位 置 控 制 、 颜 色 键 、 软 滚动 、 可 变 窗 口 尺寸 等 。 显 示 控 制 单 
元 支持 的 颜色 格式 包括 RGB (1BPP 到 24BPP) 和 YCbCr4:4:4《〈 限 于 内 部 总 线 )。S3C6410X 
的 显示 控制 的 原理 图 如 图 9-2 所 示 。 


EN 


FIFO I/F 


DISPLAY CONTROLLER 


VTIME RGB TV VTIME 180 


Post Proc. 


601 IF 


x 


TV Saler TV Encoder 


图 9-2 S3C6410X 的 LCD 控制 器 原理 图 


9-3 显示 了 16BPP 模式 下 的 LCD 数据 线 与 颜色 的 对 应 关系 。 


LCD Panel 


图 9-3 16BPP 模式 下 的 屏幕 像素 分 布 
屏幕 各 点 的 像素 在 内 存 中 的 分 布 见 表 9-1。 
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表 9-1 视频 内 存 分 布 


D[31] D[30:16] D[15] D[14:0] 
000H AENI PI AEN2 P2 
004H AEN3 P3 AEN4 P4 
008H AENS P5 AEN6 P6 


BSWP = 0, HWSWP = 0 


D[31] D[30:16] D[15] D[14:0] 
000H AEN2 P2 AENI PI 
004H AEN4 P4 AEN3 P3 
008H AENG P6 AENS P5 


BSWP-0, HWSWP -1 


S3C6410X 的 RGB 形式 的 显示 接口 的 信号 线 见 表 9-2. 


表 9-2 RGB 形式 的 显示 接口 的 信号 线 


名 —W 方 W Jj — 
RGB HSYNC 输出 水 平 同步 信号 
RGB VSYNC 输出 帧 同步 信号 
RGB VCLK 输出 像素 时 钟 
RGB _ VDEN 输出 数据 允许 
RGB VD[23:0] 输出 RGB 数据 线 


S3C6410X 的 RGB 形式 的 显示 的 时 序 如 图 9-4 所 示 。 


INT FrSyn | | 
(internal) ——À À9——————————————————— ----- &R-- 


hæ =< i 
VSPW+1 VBPD+1 


1 LINE 


RGB_HSYNC | | MR le. 
g 1 Se 1 
1 1 I 1 1 
nmm 
won vo IK X K KC XA X XC T 


I 
RGB_VDEN | | | 
I 


2 a ———————————— —— en 
HSPW-*1 HRPD+1 HOZVAL-*1 HFPD-*1 
VSPW-0,VBPD-0,VFPD-0,HSPW-1,HBPD-1,HFPD-1 


图 9-4 S3C6410X RGB 显示 时 序 
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VPRCS 模块 的 主要 功能 是 窗口 混合 。 显 示 控 制 器 有 5 个 窗口 层 ， 有 具体 如 下 : 


窗口 
窗口 
窗口 
窗口 


0 GEX): YCbCr， 没 有 调 
1 Gs 1): RGB 调 色 板 
2 (覆盖 2» RGB 调 色 板 


色 板 的 RGB 


3 GEI: 16 级 颜色 LUT 的 RGB (1/2/4) 


窗口 


窗口 2、 


4 光标 区 ) 带 4 级 颜色 LUT 的 RGB(1/2) 


窗口 3 和 窗口 4 EA 


色 限 制 ， 通 过 颜色 LUT 的 索引 进行 设置 ， 这 个 特性 可 


3 
减 小 整个 系统 的 数据 量 ， 并 提高 系统 的 运行 性 能 。5 个 窗口 的 覆盖 优先 级 如 下 : 


窗口 


S3C6410X 的 VTIME 单元 3 
RGB 接口 、ITU R601 接 


4> 窗 口 3> 窗 口 2> 1> 


窗口 0 


要 分 为 两 个 模块 。 一 个 是 VTIME RGB TV 模块 ， 用 于 


和 TV 编码 器 接口 时 序 控制 。 另 一 个 是 用 于 I80 接口 时 序 控制 


的 模块 。 在 VTIME RGB TV 模式 下 ，VTIME 产生 控制 信号 ， 如 RGB-VSYNC. RGB - 
HSYNC RGB VDEN 和 RGB VCLK 信号 。 这 些 控制 信号 与 VSFR 寄存 器 内 的 


VIDTCON0/1/2 寄存 器 的 配置 有 很 大 的 关系 。 根 据 VSFR 内 显示 控制 寄存 器 的 可 编程 本 


EL? 


tu 


VTIME 模块 可 以 产生 相应 的 控制 信号 ， 这 些 控制 信号 适合 多 种 类 型 的 显示 设备 。 
S3C6410X 寄存 器 中 的 水 平 像 素数 为 HOZVAL， 重 直行 数 为 LINEVAL: 


HOZVAL = (水 平 显示 尺寸 ) -1 
LINEVAL = (垂直 显示 尺寸 ) -1 


RGB VCLK 信和 号 的 速率 可 以 


方法 如 下 : 


VIDCONO 寄存 器 内 的 CLKVAL 域 控制 ， 具 体 计 算 


RGB_VCLK(Hz)}HCLK/(CLKVAL+1) CLKVAL>=1 


至 于 帧 频率 ， 


其 实 就 是 VSYNC 信和 号 的 频率 ， 它 与 LCDCON1 和 LCDCON2 / 3 / 4 寄存 


A HJ VSYNC. VB2PD. 、VFPD 、LINEVAL 、HSYNC 、HBPD 、HFPD HOZVAL 和 


CLKVAL 都 有 关系 。 大 多 数 LCD U 


给 出 的 计算 公式 如 下 : 


动 器 都 需要 与 显示 器 匹配 的 帧 频率 。S3C6410X 手册 上 


Frame Rate = 1/ ( [(VSPW-1) + (VBPD+1) + (LIINEVAL + 1) + (VFPD+1) ] X[(HSPW+1) + (HBPD 
+1)+ (HFPD+1)+ (HOZVAL + 1) |X { [ CLKVAL-1 )/(Frequency of Clock source ) ] | 


K 9-3—3X 9-6 列 出 了 S3C6410X 的 主要 显示 控制 寄存 器 相关 参数 。 


表 9-3 显示 主 控制 寄存 器 0 


VIDCONO 位 do x 3] 始 值 
Reserved [31:30] 保留 0 
INTERLACE F [29] 0: 顺序 的 ，1: 交叉 的 0 
Reserved [28] 保留 0 
显示 输出 格式 : 
wi | mam | MR QUON : 
1: 180 I/F for LDII 


213 


214 


Linux 驱动 程序 开发 实例 第 2 版 

( 续 ) 

VIDCONO 位 Hi X 初 始 值 
L1_DATA16 25: 23] 180 VF LD1 的 输出 数据 格式 0 
LO DATA16 22: 20] 180 T/F LDO 的 输出 数据 格式 0 
Reserved [19] 保留 0 
PNRMODE 18: 17] RGB 显示 模式 0 
CLKVALUP [16] CLKVAL F 更 新 时 间 控 制 0 
Reserved 15: 14] 保留 0 
CLKVAL F [13: 6] 决定 VCLK 与 CLKVAL[7:0] 的 比例 0 
VCLKFREE [5] VCLK 运行 控制 0 
CLKDIR [4] 时 钟 源 选择 0 
CLKSEL F [3: 2] 视频 时 钟 源 0 
ENVID a ALB HERI RPG f fe LE 0 
ENVID F [0] 1i 2A B p A Fe AUR HEURE EIU S f 55 ME. 0 

表 9-4 显示 主 控制 寄存 器 1 

VIDCONI 位 描 XR 初 95 4H 
LINECN [26:16] 提供 行 计 数 器 状态 0 
FSTATUS [15] 区 域 状态 0 
VSTATUS [14:13] 垂直 状态 0 
Reserved [10:8] 保留 0 
IVCLK [7] ZB VCLK 活动 边沿 的 极 性 0 
IHSYNC [6] EH] HSYNC 脉冲 极 性 0 
IVSYNC [5] HI VSYNC 脉冲 极 性 0 
IVDEN [4] #8 VDEN 脉冲 极 性 0 
Reserved [3:0] 保留 0 

表 9-5 显示 主 控制 寄存 器 2 

VIDCON2 位 fü — XR 初 95 4H 
: [31:24] 保留 0 
EN601 [23] 空 制 ITU601 输出 使 能 0 
: [22:15] ER 0 
TVFORMATSELO [14] HBJ YUV 数据 格式 选择 方式 0 
TVFORMATSELI [13:12] RI YUV 数据 输出 格式 0 
[11:9] 保留 0 
OrgYCbCr [8] RIJ YUV 数据 的 顺序 0 
YUVOrd [7] HEJ Chroma 数据 的 顺序 0 
p [6:0] 保留 0 
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表 9-6 Window0 控制 寄存 器 


WINCONO 位 描 o x 4] ia 值 
ION: [27:26] M 输入 值 范围 选择 从 YCbCr 到 RGB 的 颜色 空间 转换 前 
Reserved [25:23] 保留 0 
ENLOCAL 22 数据 传输 方式 选择 0 
BUFSTATUS 21 缓冲 状态 0 
BUFSEL 20 缓冲 区 状态 设置 0 
BUFAUTOEN 19 双 缓 冲 自动 控制 0 
BITSWP 18 位 交换 控制 0 
BYTSWP 17 字 节 交换 控制 0 
HAWSWP 16 半 字 交换 控制 0 
reserved [15:14] 保留 0 
InRGB 13 旧 明 源 图 像 的 输入 颜色 空间 0 
Teserved [12:11] 保留 0 
BURSTLEN [10:9] DMA 的 突 发 最 大 长 度 选择 0 
Reserved [8:6] 保留 0 
BPPMODE F [5:2] 选择 BPP 模式 0 
Reserved [1] 保留 0 
ENWIN F [0] 视频 输出 与 控制 信号 使 能 0 


9.3 S3C6410X LCD 驱动 程序 实例 


9.3.1 ”注册 与 初始 化 


本 节 在 s3c-fb.c 的 基础 上 分 析 S3C6410X 的 LCD 驱动 程序 。S3C6410X 的 LCD 驱动 程 
序 的 平台 驱动 结构 定义 如 下 : 


static struct platform driver s3c fb driver = { 


.probe = s3c fb probe, 
remove = s3c fb remove, 
.jd table ^ —s3c fb driver ids, 
.driver ={ 
.name = "s3c-fb", 
.pm =&s3cfb pm ops, 
h 
h 
/平台 驱动 入 口 


module platform driver(s3c fb driver); 


平台 探测 函数 s3c fb probe 主要 完成 LCD 控 
册 一 个 Framebuffer 驱动 : 


zy 


症 器 的 初始 化 和 显示 绥 存 的 分 配 ， 最 后 注 
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static int s3c fb probe(struct platform device *pdev) 


1 


const struct platform device id *platid; 

struct s3c fb driverdata *fbdrv; 

struct device *dev = &pdev-^dev; 

struct s3c fb platdata *pd; 

struct S3c fb *sfb; 

struct resource *res; 

int win; 

int ret = 0; 

u32 reg; 

platid = platform get device id(pdev); 

fbdrv = (struct s3c fb driverdata *)platid-^driver data; 

// 判 断 窗口 数量 是 否 超标 

if (fbdrv->variant.nr windows > S3C FB MAX WIN) ( 
dev err(dev, "too many windows, cannot attach"); 


— 


return -EINVAL; 
j 
pd- dev get platdata(&pdev-^dev); 
if (!pd) ( 
dev err(dev, "no platform data specified"); 
return -EINVAL; 
j 
sfb = deym kzalloc(dev, sizeof(struct s3c fb), GFP. KERNEL); 
if (!sfb) { 
dev err(dev, "no memory for framebuffers\n"); 
return -ENOMEM; 
j 


dev dbg(dev, "allocate new framebuffer ?op n", sfb); 
sfb->dev = dev; 
sfb->pdata = pd; 
sfb->variant = fbdrv->variant; 
spin_lock init(&sfb->slock);// 初 始 化 锁 
/获取 时 钟 
sfb->bus_clk = devm clk get(dev, "lcd"); 
if (IS_ERR(sfb->bus_clk)) { 
dev_err(dev, "failed to get bus clock\n"); 
return PTR_ERR(sfb->bus_clk); 
} 
/使 能 时 钟 
clk prepare enable(sfb-^bus clk); 
if (!sfb-^variant.has clksel) { 
sfb->lcd clk= devm clk get(dev, "sclk fimd"); 
if(IS ERR(sfb--lcd clk)) { 
dev err(dev, "failed to get lcd clock n"); 
ret = PTR. ERR(sfb-^lcd clk); 
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goto err bus clk; 

j 

clk prepare enable(sfb->lcd clk); 
j 
pm runtime enable(sfb-^dev); 
/获取 IO 资源 
res — platform get resource(pdev, IORESOURCE MEM, 0); 
sfb->regs = deym ioremap resource(dev, res); 
if (IS ERR(sfb-regs)) { 

ret = PTR. ERR(sfb-^regs); 

goto err led clk; 


} 
/获取 中 断 资 源 
res — platform get resource(pdev, IORESOURCE IRQ, 0); 
if (Ires) { 
dev err(dev, "failed to acquire irq resource n"); 
ret = -ENOENT; 
goto err led clk; 
} 


Sfb-^irq no = res->start; 
ret = devm request irq(dev, sfb->irq no, s3c fb irq,0, "s3c fb", sfb);/ 申 请 中 断 
if (ret) { 

dev err(dev, "irq request failedn"); 


goto err led clk; 
} 
dev dbg(dev, "got resources (regs %p), probing windows\n", sfb->regs); 
platform set drvdata(pdev, sfb); 
pm runtime get sync(sfb--dev); 
lie GPIO*/ 
pd-^setup gpio(); 
/以 下 初始 化 硬件 设置 
writel(pd->vidconl, sfb->regs + VIDCONI); 
if (sfb-—variant.has fixvclk) { 
reg = readl(sfb-^regs + VIDCONI1); 
reg &- -VIDCONI VCLK MASK; 
reg |= VIDCON1. VCLK RUN; 
writel(reg, sfb-^regs + VIDCONI); 


} 
[*'&i Eg ES 


for (win = 0; win < fbdrv-variant.nr windows; win++) 


s3c fb clear win(sfb, win); 

for (win = 0; win < (fbdrv->variant.nr windows - 1); win++) { 
void iomem *regs = sfb->regs + sfb--variant.keycon; 
regs += (win * 8); 
writel(Oxffffff, regs + WKEY CONO); 
writel(Oxffffff, regs + WKEYCONI); 
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j 
S3c fb set rgb timing(sfb); 
PO) OI I 


for (win = 0; win < fbdrv-^variant.nr windows; win) { 


if (!Ipd-—win[win continue; 
ret —s3c fb probe win(sfb, win, fbdrv-win[win],&sfb-—windows[win]); 
if (ret < 0) 1 
dev err(dev, "failed to create window %d\n", win); 
for (; win >= 0; win--)s3c fb release win(sfb, sfb-^windows[win]); 
goto err pm runtime; 


} 
platform set drvdata(pdev, sfb); 
pm runtime put sync(sfb-^dev); 
return 0; 
err pm runtime: 
pm runtime put sync(sfb-»dev); 
err lcd clk: 
pm runtime disable(sfb-^dev); 
If (!sfb-^variant.has clksel) 
clk disable unprepare(sfb-^lcd clk); 


em bus clk: 
clk disable unprepare(sfb-^bus clk); 
return ret; 

} 


S3C6410X 的 LCD 控制 器 包含 多 个 窗口 。 每 个 窗口 注册 一 个 Framebuffer 驱动 : 
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static int s3c fb probe win(struct s3c fb *sfb, unsigned int win no, 
struct s3c fb win variant *variant,struct s3c fb win **res) 


struct fb var Screeninfo *var; 

struct fb videomode initmode; 

struct s3c fb pd win *windata; 

struct s3c fb win *win; 

struct fb. info *fbinfo; 

int palette size; 

int ret; 

dev dbg(sfb--dev, "probing window %d, variant %p\n", win no, variant); 
init waitqueue head(&sfb--vsync info.wait); 
palette size = variant-^palette sz * 4; 

/分 配 fb info 


fbinfo = framebuffer alloc(sizeof(struct s3c fb win) palette size * sizeof(u32), sfb->dev) 


if (!fbinfo) ( 
dev err(sfb-^dev, "failed to allocate framebuffer n"); 
return -ENOENT; 
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windata = sfb-^pdata-—win[win no]; 
initmode = *sfb-^pdata-^vtiming; 
win = fbinfo-^par; 
*res — win; 
var = &fbinfo--var; 
win--variant = *variant; 
win->fbinfo = fbinfo; 
win-»parent = sfb; 
win->windata = windata; 
win->index = win no; 
win->palette_buffer = (u32 *)(win + 1); 
ret = s3c_fb_alloc_memory(sfb, win); 
if (ret) { 

dev_err(sfb->dev, "failed to allocate display memory\n"); 


return ret; 
j 
/设置 调 色 板 
让 (win->variant.palette 16bpp) 1 
/# 默 认为 RGB 5:6:5 格式 */ 
win->palette.r.offset = 11;win->palette.r.length = 5;win->palette.g.offset = 5; 
win->palette.g.length = 6;win->palette.b.offset = 0;win->palette.b.length = 5; 
} else { 
/*RGB888 模式 */ 
win->palette.r.offset = 16;win->palette.r.length = 8;win->palette.g.offset = 8; 
win->palette.g.length = 8;win->palette.b.offset = 0;win->palette.b.length = 8; 
j 


PSCECTAG TUUS */ 
initmode.xres = windata-»xres; 


initmode.yres = windata--yres; 
fb videomode to var(&fbinfo-^var, &initmode); 


fbinfo-^fix.type —FB TYPE PACKED PIXELS; 
fbinfo-^fix.accel —FB ACCEL NONE; 
fbinfo--var.activate —FB ACTIVATE NOW; 
fbinfo--var.vmode =FB VMODE NONINTERLACED; 
fbinfo-^var.bits per pixel = windata->default bpp; 
fbinfo-^fbops — &s3c fb ops; 

fbinfo->flags —FBINFO FLAG DEFAULT; 
fbinfo-^pseudo palette = &win-»pseudo palette; 

PRSE RAI 


ret = s3c fb check var(&fbinfo--var, fbinfo); 

if (ret < 0) 1 
dev err(sfb-^dev, "check var failed on initial video params n"); 
return ret; 

j 

[PG EPIS AUI */ 


ret = fb alloc cmap(&fbinfo-^cmap, win-^variant.palette sz, 1); 
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if (ret == 0) 
fb set cmap(&fbinfo-^cmap, fbinfo); 
else 
dev err(sfb--dev, "failed to allocate fb cmapWn"); 
S3c fb set par(fbinfo); 
dev dbg(sfb--dev, "about to register framebuffer n"); 
/注册 framebuffer 驱动 
ret — register framebuffer(fbinfo); 
if (ret < 0) { 
dev_ err(sftb->dev, "failed to register framebuffer\n"); 


return ret; 
} 
dev info(sfb->dev, "window %d: fb os", win no, fbinfo->fix.id); 


return 0; 


9.3.2 fb ops 实现 
S3C6410X Framebuffer 驱动 的 fb. ops 结构 定义 如 下 : 


static struct fb ops s3c fb ops- { 
.owner = THIS MODULE, 
.fb check var -s3c fb check var, 
.fb set par= s3c fb set par, 
.fb blank = s3c fb blank, 
.fb setcolreg = s3c fb setcolreg, 
.fb fillrect — —cfb fillrect, 
.fb copyarea = cfb copyarea, 
.fb imageblit = cfb imageblit, 


.fb pan display =s3c fb pan display, 
.fb ioctl = s3c fb ioctl, 
h 
中 fb fillrect. fb copyarea. fb imageblit 等 几 个 函数 采用 了 Linux 内 核 中 通用 的 操作 
函数 cfb fillrect、cfb fillrect、cfb imageblit。 图 9-5 为 Framebuffer 驱动 接口 的 实现 。 


S3c-fb.c( 用 户 实现 的 部 分 ) 
S3cfb check var/s3cfb set par/s3cfb setcolreg/s3cfb pan display 


; Struct fb ops s3c fb ops 
struct file operations fb fops RI siio So fb m 
S——— MÁÁ A — 


TU cfbcopyarea.c cfbfillrect.c cfb imageblit 
mmap/open/release cfb copyarea cfb fillrect cfbimgblt.c 


图 9-$ framebuffer 驱动 程序 接口 实现 


s3cfb pan display 函数 用 于 处 理 虚拟 屏 的 游 动 显示 ， 如 设置 虚拟 屏 的 显示 偶 移 量 等 。 
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static int s3c fb pan display(struct fb. var screeninfo *var,struct fb. info *info) 


1 


struct s3c fb win *win = info-»par; 
struct s3c fb *sfb = win-»parent; 
void  iomem *buf = sfb->regs + win->index * 8; 


unsigned int start boff, end boff, 
pm runtime get sync(sfb-^dev); 
POSEE So PCR ES n E */ 
start boff = var-»yoffset * info-^fix.line length; 
/*X offset. 依赖 当前 每 像素 的 bit 数 */ 
if (info->var.bits_per pixel >= 8) { 
start boff += var-^xoffset * (info-^var.bits per pixel >> 3); 
} else ( 
switch (info-^var.bits per pixel) { 


case 4: 
start boff += var-»xoffset >> 1; 
break; 

case 2: 
start boff += var-»xoffset >> 2; 
break; 

case 1: 
start boff += var-»xoffset >> 3; 
break; 

default: 
dev err(sfb-»dev, "invalid bpp n"); 
pm runtime put sync(sfb-^dev); 
return -EINVAL; 


j 
POREDGE cs D sts Fe BE En / 

end boff- start boff + info-^var.yres * info-^fix.line length; 
/关闭 窗口 刷新 以 更 新 缓冲 地 址 

shadow protect win(win, 1); 
writel(info-^fix.smem start + start boff, buf + sfb-^variant.buf start); 
writel(info-^fix.smem start + end boff, buf + sfb-—variant.buf end); 
shadow. protect win(win, 0);// 重 新 使 能 刷新 

pm runtime put sync(sfb->dev); 

return 0; 


j 
s3cfb blank 函数 用 来 清空 屏幕 : 


static int s3c fb blank(int blank mode, struct fb info *info) 
1 

struct s3c fb win *win = info->par; 

struct s3c fb *sfb = win->parent; 

unsigned int index = win->index; 
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u32 wincon; 

u32 output on = sfb->output on; 

dev dbg(sfb->dev, "blank mode %d\n", blank mode); 

pm runtime get sync(sfb-^dev); 

wincon = readl(sfb->regs + sfb-^variant.wincon + (index * 4)); 

switch (blank mode) { 

case FB BLANK POWERDOWN:/ 断 电 
wincon &- -WINCONx ENWIN; 
sfb-^enabled &- ~(] << index); 

case FB BLANK. NORMAL:/ 正 常 清空 
shadow protect win(win, D;/ 禁 止 刷新 ， 保 护 窗 
writel(WINxMAP MAP | WINXMAP MAP COLOUR(0xO), 

sfb->regs + sfb-^variant.winmap + (index * 4)); 


shadow protect win(win, 0); 
break; 
case FB BLANK UNBLANK:/ 取 消 blank 
shadow protect win(win, 1); 
writel(0x0, sfb->regs + sfb-»variant.winmap + (index * 4)); 
shadow protect win(win, 0); 
wincon |= WINCONx ENWIN; 
sfb-^enabled |= (1 << index); 
break; 
case FB BLANK VSYNC SUSPEND: 
case FB BLANK HSYNC SUSPEND: 


default: 
pm runtime put sync(sfb-^dev); 
return 1; 

j 


shadow protect win(win, 1); 

writel(wincon, sfb->regs + sfb-variant.wincon + (index * 4)); 
/ 根据 sfb->enabled 做 出 使 能 /禁止 动作 

s3c fb enable(sfb, sfb->enabled ? 1 : 0); 

shadow protect win(win, 0); 


pm runtime put sync(sfb--dev); 
return output on == sfb-^output on; 


j 
由 于 篇 幅 有 限 ， 其 他 函数 请 参见 内 核 。 


9.3.3 DMA 传输 机 制 
S3C6410X 使 用 DMA 向 屏幕 传输 视频 数据 。S3C6410X 显卡 内 存 分 配 函 数 如 下 : 


static int s3c fb alloc memory(struct s3c fb *sfb, struct s3c fb win *win) 


1 
struct s3c fb pd win *windata = win->windata; 


unsigned int real size, virt size, size; 
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struct fb info *fbi = win->fbinfo; 
dma addr t map dma; 
dev dbg(sfb-^dev, "allocating memory for display n"); 
real size = windata-7xres * windata--yres; 
virt size = windata-^virtual x * windata-^virtual y; 
dev dbg(sfb--dev, "real size=%u (%u.%u), virt_size=%u (%u.%u)\n", 
real size, windata-»xres, windata-—yres, 
virt size, windata-^virtual x, windata-^virtual y); 
size = (real size > virt size) ? real size : virt size; 
size *— (Windata->max bpp > 16) ? 32 : windata-^max bpp; 
size /= 8; 
fbi-^fix.smem len = size; 
size - PAGE ALIGN(size); 
dev dbg(sfb->dev, "want %u bytes for window Wn", size); 
fbi-^screen base = dma alloc writecombine(sfb-^dev, size.&map dma, GFP KERNEL); 
if (!fbi-^screen base) 
return -ENOMEM; 
dev dbg(sfb-^dev, "mapped %x to Vop n", 
(unsigned int)map dma, fbi-^screen base); 
memset(fbi-^screen base, 0x0, size); 
fbi-^fix.smem start = map dma; 
return 0; 


} 
Framebuffer 驱动 中 分 配 DMA 内 存 通 党 使 用 dma alloc writecombine 函数 ， 而 不 是 
dma alloc coherent 函数 。 两 个 函数 的 区 别 在 于 dma alloc_coherent 函数 会 禁止 cache 与 写 缓 
yP; 而 dma alloc writecombin 函数 只 禁止 cache 但 启用 写 缓冲 。 


void *dma alloc writecombine(struct device *dev, size t size,dma addr t *dma addr, gfp t gfp); 


分 配 的 显存 物理 


LH 


dma alloc writecombine 函数 返回 显存 虚拟 地 址 ， 其 dma addr 参数 返 
地 址 。 
S3C6410X Framebuffer 驱动 的 平台 设备 定义 如 下 : 


TH 


static struct resource s3c fb resource[] = { 
[0] = DEFINE RES MEM(S3C PA FB, SZ 16K), 
[1] DEFINE RES IRQ(IRQ LCD VSYNC), 
[2] = DEFINE RES IRQ(IRQ LCD FIFO), 
[3] = DEFINE RES IRQ(IRQ LCD SYSTEM), 


h 
struct platform device s3c device fb = { 
.name — "s3c-fb", 
id =-], 
.num resources = ARRAY SIZE(s3c fb resource), 
resource = s3c fb resource, 
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.dev ={ 


.dma mask — &samsung device dma mask, 
.coherent dma mask — DMA BIT MASK(32), 


js 


这 里 的 两 个 DMA 参数 很 重要 。dma mask 5 coherent dma mask 均 表 示 设 备 能 寻 址 的 
范围 。 其 中 coherent dma mask 用 于 申请 一 致 性 DMA 缓冲 区 。dma_alloc_writecombine 函数 
需要 根据 coherent dma mask 参数 分 配 内 存 。dma alloc writecombine 函数 会 调用 dma alloc_ 
attrs 函数 : 


static inline void *dma alloc attrs(struct device *dev, size t size,dma addr t *dma handle, gfp t flag, 
struct dma attrs *attrs) 


struct dma map ops *ops = get dma ops(dev); 
void *cpu addr; 
BUG ON(!ops); 
if(dma alloc from coherent(dev, size, dma handle, &cpu addr)) 
return cpu. addr; 
if (larch dma alloc attrs(&dev, &flag)) 
return NULL; 
if (lops-^alloc) 
return NULL; 
cpu addr = ops-»alloc(dev, size, dma handle, flag, attrs); 
debug dma alloc coherent(dev, size, *dma handle, cpu addr); 
return cpu. addr; 
} 


ARM 体系 的 DMA 操作 结构 为 arm_dma_ops: 


struct dma map ops arm dma ops={ 


.alloc —arm dma alloc, 
.free = arm dma free, 
.mmap —arm dma mmap, 


.get sgtable — — arm dma get sgtable, 
.map page —arm dma map page, 
.unmap page - arm dma unmap page, 
.map sg —arm dma map sg, 
.unmap sg —arm dma unmap sg, 


.Sync single for cpu — arm dma sync single for cpu, 


.Sync single for device- arm dma sync single for device, 


Sync sg for cpu — arm dma sync sg for cpu, 
.Sync sg for device  — arm dma sync sg for device, 
.Set dma mask = arm dma set mask, 


Js 


arm dma alloc 函数 调用 _dma alloc Kt, _ dma aloce K% t SHa] DMA mask 
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static void * dma alloc(struct device *dev, size t size, dma addr t *handle, 


gfp t gfp, pgprot t prot, bool is coherent,struct dma attrs *attrs, const void *caller) 


u64 mask = get coherent dma mask(dev); 
struct page *page = NULL; 

void *addr; 

bool want vaddr; 


if (Ymask)return NULL; 
if (mask < OxffffffffULL) 
gfp |= GFP DMA; 
gfp&--( GFP COMP); 
*handle - DMA ERROR CODE; 
size - PAGE ALIGN(size); 
want vaddr- !dma get att(DMA ATTR NO KERNEL MAPPING, attrs); 
/根据 参数 与 处 理 器 情况 分 配 内 存 


if (nommu()) 


addr = —alloc simple buffer(dev, size, gfp, &page); 
else if (dev get cma area(dev) && (gp & | GFP DIRECT RECLAIM)) 

addr =  alloc from contiguous(dev, size, prot, &page,caller, want vaddr); 
else if (is coherent) 

addr = —alloc simple buffer(dev, size, gfp, &page); 
else if (!gfpflags allow blocking(gfp)) 

addr = — alloc from pool(size, &page); 
else 

addr = — alloc remap buffer(dev, size, gfp, prot, &page,caller, want vaddr); 
if (page) 

*handle = pfn to dma(dev, page to pfn(page)); 
return want vaddr ? addr : page; 


j 


DMA 地 址 必须 填充 到 S3C6410X 的 LCD 控制 器 的 地 址 寄存 器 中 。S3C6410X 的 窗 
地 址 与 大 小 寄存 器 见 表 9-7。 


xX 


表 9-7 S3C6410X 的 窗口 缓冲 地 址 与 大 小 寡 存 器 


组 


寄 存 器 地 n R/W 描 — X £ 位 值 
VIDWOOADDOBO 0x771000A0 R/W Window 0’s buffer start address register, buffer 0 0x0000 0000 
VIDWOOADDOBI 0x771000A4 R/W Window 0’s buffer start address register, buffer 0x0000 0000 
VIDWOIADDOBO 0x771000A8 R/W Window 1’°s buffer start address register, buffer 0 0x0000 0000 
VIDWOIADDOBI 0x771000AC R/W Window 1’°s buffer start address register, buffer 1 0x0000 0000 

VIDW02ADDO 0x771000B0 R/W Window 2's buffer start address register 0x0000 0000 
VIDWO3ADDO 0x771000B8 R/W Window 3's buffer start address register 0x0000 0000 
VIDWO4ADDO 0x771000C0 R/W Window 4's buffer start address register 0x0000 0000 
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CX) 

寄 存 器 地 m R/W 描 ” 述 复 位 fH 
VIDWOOADDIBO 0x771000D0 R/W Window 0’s buffer end address register, buffer 0 0x0000 0000 
VIDWOOADDIBI 0x771000D4 R/W Window 0’s buffer end address register, bufferl 0x0000 0000 
VIDWOIADDIBO 0x771000D8 R/W Window 1’s buffer end address register, buffer 0 0x0000 0000 
VIDWOIADDIBI 0x771000DC R/W Window 1’s buffer end address register, buffer 1 0x0000 0000 

VIDWO2ADDI 0x771000EO0 R/W Window 2's buffer end address register 0x0000 0000 
VIDWO3ADDI 0x771000E8 R/W Window 3's buffer end address register 0x0000 0000 
VIDWOAADDI 0x771000F0 R/W Window 4's buffer end address register 0x0000 0000 
VIDWO0ADD2 0x77100100 R/W Window O's buffer size register 0x0000 0000 
VIDWOIADD2 0x77100104 R/W Window 1’s buffer size register 0x0000 0000 
VIDWO02ADD2 0x77100108 R/W Window 2's buffer size register 0x0000 0000 
VIDWO3ADD2 0x7710010C R/W Window 3's buffer size register 0x0000 0000 
VIDWO04ADD2 0x77100110 R/W Window 4's buffer size register 0x0000 0000 


这 些 寄存 器 的 宏 定 义 如 下 : 


/*Video buffer addresses*/ 


#define VIDW BUF START( buff) (0xAO0 + ((. buff) * 8)) 
#define VIDW BUF START S( buff) (0x40A0 + ((. buff) * 8)) 
#define VIDW BUF STARTI( buff) (0x A4 + (( buff) * 8)) 
#define VIDW BUF END( buff) (0xDO + ((. buff) * 8)) 
#define VIDW BUF ENDI( buff) (0xD4 + ((. buff) * 8)) 
#define VIDW BUF SIZE( buff) (0x100 + ((_ buff) * 4)) 


s3c fb data 64xx 结构 记录 了 这 些 参数 信息 : 


static struct s3c fb driverdata s3c fb data 64xx={ 


.variant — ( 


j * 
.win[0] 
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.nr windows 
.Vidtcon 
.Wincon 
.Winmap 
.keycon 
.osd 

.osd stride 
.buf start 
.buf size 
.buf end 
.palette = ( 


[0] = 0x400, [1] = 0x800, [2] = 0x300, [3] = 0x320, [4] = 0x340, 


j 
.has prtcon 
.has clksel 


一 5, 

= VIDTCONO, 

= WINCON(0), 

= WINXxMAP(0), 

- WKEYCON, 

- VIDOSD BASE, 

= 16, 

= VIDW BUF START(0)， 
- VIDW BUF SIZE(0), 

= VIDW BUF END(0), 


=], 
=], 


= &s3c fb data 64xx wins[0], 
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.win[1] — &s3c fb data 64xx wins[1], 
.win[2] — &s3c fb data 64xx wins[2], 
.win[3] — &s3c fb data 64xx wins[3], 
.win[4] — &s3c fb data 64xx wins[4], 
h 
static const struct platform device id s3c fb driver ids[] = { 
1 
.name — "s3c-fb", 
«driver data — (unsigned long)&s3c fb data 64xx, 
Jo 
5 


s3c fb set par 函数 将 DMA 地 址 写 入 相应 的 寄存 器 : 


static int s3c fb set par(struct fb info *info) 
1 
struct fb var screeninfo *var = &info--var; 
struct s3c fb win *win = info-^par; 
struct s3c fb *sfb = win->parent; 
void  iomem *regs = sfb->regs; 
void  iomem *buf = regs; 
int win no = win->index; 
buf= regs + win no * 8; 
writel(info-^fix.smem start, buf + sfb->variant.buf start); 
data = info-^fix.smem start + info-^fix.line length * var->yres; 
writel(data, buf + sfb-^variant.buf end); 


9.3.4 ”内 核 配 置 


内 核 也 要 做 相关 配置 ， 执 行 make menuconfig 命令 ， 在 【devices drivers】->【graphics 
support] -> [Frame buffer Devices】 中 进行 配置 ， 如 如 图 9-6 所 示 。 


Support for frame buffer devices 一 -一 > 
Framebuffer foreign endianness support 一 一 一 
Enable Video Mode Handling Helpers 

Enable Tile Blitting Support 

*** Frame buffer hardware drivers +*+ 

> ARM PrimeCell PL110 support 

> ÜpenCores VGA/LCD core 2.0 framebuffer support 
> Epson S1ID13XXX framebuffer support 
? 
] 
> 


ok 
[ 
[ 
[ 


Lacan 


*» Samsung S3C framebuffer support 


Debug register writes 


< 
< 
< 
[ 
< > SMSC UFX6000/TO00 USB Framebuffer support 


图 9-6 [Frame buffer Devices] WA 


9.4 Framebuffer 应 用 层 


Framebuffer 应 用 层 针对 /dev/fbn 设备 节点 进行 操作 。 
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例 9.1 Framebuffer 应 用 层 测试 程序 
代码 见 \samples\9LCD\9-1fbtest。 核 心 代码 如 下 : 


int main(int argc, char *argv[]) 
1 
int i, fd, fbfd; 
struct fb. var screeninfo vinfo; 
struct fb. fix screeninfo finfo; 
. u8 *fb buf, 
intfb xres,fb yres,fb bpp; 
. U32 screensize; 
fbfd = open("/dev/fb1", O_RDWR); 
if (fbfd < 0) ( 
fbfd — open("/dev/fb/0", O RDWR); 
if(fbfd«O0) ( 
printf("Error: cannot open framebuffer device. n"); 
return -1; 


} 
/ 获取 fb fix screeninfo 
if (ioctl(fbfd, FBIOGET FSCREENINFO, &finfo)) { 
printf("Error reading fixed information. n"); 
close(fbfd); 
return -1; 
} 
// 获取 fb var screeninfo 
if (ioctl(fbfd, FBIOGET VSCREENINFO, &vinfo)) { 
printf("Error reading variable information. n"); 
close(fbfd); 
return -1; 
} 
printf("%dx%d, %dbpp\n", vinfo.xres, vinfo.yres, vinfo.bits per pixel); 
fb xres — vinfo.xres; 
fb yres — vinfo.yres; 
fb bpp -vinfo.bits per pixel; 
/计算 屏幕 太 十 
screensize = vinfo.xres * vinfo.yres * vinfo.bits per pixel / 8; 
fb buf- (char *)mmap(0, screensize, PROT READ | PROT WRITE, MAP SHARED,fbfd, 0); 
if ((int)fb buf == -1) ( 
printf("Error: failed to map framebuffer device to memory.n"); 
close(fbfd); 
return -1; 
} 
memset(fb_buf,200,screensize); 
printf("ummap framebuffer device to memory.\n"); 
sleep(10); 
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munmap(fb buf, screensize); 
close(fbfd); 
return 0; 


j 
测试 结果 为 屏幕 全 部 被 绘 成 深 红色 。 


9.5 Qt 界面 系统 移植 


Qt 是 一 个 跨 平 台 的 图 形 界面 库 ， 它 不 仅 包 含 丰 富 的 界面 组 件 ， 还 包括 网 络 、 数 据 库 、 
XML, Web 等 应 用 开发 组 件 ， 可 以 与 微软 的 Visual Studio 媲美 。Qt 在 嵌入 式 Linux. 系统 9 
的 应 用 非常 广泛 。Qt 支持 Linux 的 Framebuffer 驱动 。 

下 面 是 Qt 5.6 在 S3C6410X 平台 上 的 移植 步骤 。 

(1) 下 载 Qt 5.6.0 的 源码 包 qt-everywhere-opensource-src-5.6.0.tar.gz。 

(2) 解压 源码 包 。 


O 


tar zxvf qt-everywhere-opensource-src-5.6.0.tar.gz 


(3) 修改 编译 配置 文件 。 配 置 文件 是 下 面目 录 中 的 qmake.conf: 


[sul 
出 


qt-everywhere-opensource-src-5.6.0/qtbase/mkspecs/linux-arm-gnueabi-g-—/ 


修改 内 容 如 下 : 
# 对 g++.conf 文件 的 修改 
QMAKE CC = arm-none-linux-gnueabi-gcc 
QMAKE CXX = arm-none-linux-gnueabi-g-— 
OMAKE LINK = arm-none-linux-gnueabi-g-—- 
QMAKE LINK SHLIB = arm-none-linux-gnueabi-g++ 
# 对 linux.conf 文件 的 修改 
QMAKE AR = arm-none-linux-gnueabi-ar cqs 
QMAKE OBJCOPY = arm-none-linux-gnueabi-objcopy 
QMAKE NM = arm-none-linux-gnueabi-nm -P 
QMAKE STRIP = arm-none-linux-gnueabi-strip 


load(qt_config) 
(D 编译 Qt。 具 体 命令 如 下 : 


./configure -release -opensource -confirm-license -plugin-sql-sqlite -xplatform linux-arm-gnueabi-g++ - 
no-dbus -no-c-—11 -no-tslib -nomake examples -qt-libjpeg -qt-libpng -qt-zlib -prefix /root/fgj/arm-2014.05/arm- 


none-linux-gnueabi 
make 
make install 


(5) 编译 例 程 。 将 qtbase/bin/qmake 复制 到 usr/lib/i386-linux-gnu/qt4/bin 目录 ， 并 进入 例 
程 目录 : 
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root(Qubuntu:-/fgj/test/QT/qt-everywhere-opensource-src-5.6.0/qtbase/examples/widgets # 


qmake 
make 


(6) 复制 库 与 字体 到 开发 板 。 将 QU 部 分 库 复 制 到 musvlib 下 ， 将 字体 文件 
/root/fej/arm-2014.05/arm-none-linux-gnueabi/lib/fonts 。 


CD 运行 例 程 。 将 Qt 自 带 的 例 程 复制 到 开发 板 ， 如 calculator 例 程 的 启动 命令 如 下 : 


复制 到 


T 


[root@urbetter /home]* ./ calculator -platform linuxfb 


屏幕 上 会 出 现 一 个 配置 对 话 框 ， 如 图 9-7 所 示 。 


0 


Backspace Clear Clear All 
| 


Sqrt 


IHI 


图 9-7 Qt 计算 器 对 话 让 
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输入 子 系 统 (input subsystem). 是 为 支持 输 
也 文 持 蜂 鸣 


间 入 设备 ， 而 日 
同 完 成 对 设备 的 控 第 


标 、 键 盘 、 触 摸 屏 等 输 
其 他 设备 驱动 融合 


x E 
体 。 本 章 将 介绍 


10.1 Linux 输入 子 系统 概述 


输入 了 于 系统 


入 设备 而 开发 的 ， 但 是 
器 、LED 等 输出 设备 。 


它 不 仅 能 用 来 支持 


二 BR 


输入 子 系统 也 经 常 和 


|， 如 USB 鼠标 就 是 USB 设备 与 输入 设备 的 结合 


Linux 中 的 输入 子 系 统 驱动 程序 开发 方法 。 


输入 设备 驱动 程序 (input drivers) 是 Linux ! 


输入 子 系统 可 以 支持 鼠标 、 键 盘 、 蜂 鸣 器 、LED ^ 
岛 器 、 


CD 输入 设备 层 : 包括 鼠标 、 键 盘 、 蜂 0 
(2) 输入 设备 驱动 层 ， 具体 设备 驱动 ， 
(3) 输入 子 系统 核心 层 : 管理 加 


输入 设备 的 事件 处 理 。 


B» 要 处 理 fii H 


为 文 持 所 有 得 入 设备 而 设计 的 一 类 驱动 程序 。 
等 设备 。 在 输入 子 系统 中 ， 共 有 站 个 层次 : 


LED 等 。 
中 断 、 读 取 输 入 事件 和 探 表 


丛 入 设备 、 事 件 接 


(D 应 用 层 : 


输入 子 系统 的 核心 元 素 之 间 通 


对 输入 设备 的 应 用 处 理 与 控制 。 
过 事件 进行 通信 。 
要 使 用 Input 子 系统 ， 需 要 确保 内 核 中 包含 了 Input 和 Event 接口 支持 。 


图 10-1 是 输入 子 系统 原理 图 。 


menuconfig 进入 【devices drivers ] -> [input devices support】]， 配 置 如 图 10-2 所 示 。 


Application(dev/mice, dev/mouse, dev/event) 


Input Handers 
(keyboard handler,mouse 
handler,event handler) 


输入 子 系统 核心 


Cinput subsystem core) 


设备 鼠标、 键盘 、LED、 蜂 鸣 器 、 触 摸 屏 等 ) 


图 10-1 输入 子 系统 原理 


10.2 Linux 输入 子 系统 原理 


输入 子 系统 定义 在 <linux/input.h> 中 。 


Input_handler 和 input_event 等 。 


输入 子 系 统 


-*- Generic input layer (needed for keyboard, mouse, ...] 


xm Support for memoryless force-Feedback devices 
xm Polled input device skeleton 
xm Sparse keymap support library 
7** Userland interfaces ww 
E House interface 


[*1 Provide legacy /dev/psaux device 

[1024] Horizontal screen resolution 
Vertical screen resolution 

Joystick interface 

Event interface 

Event debugging 


(768) 
He 


tat Input Device Drivers *** 
Keyboards ---» 

Hice --- 
Joysticks/Gamepads ---> 
Tablets ---» 

Touchscreens  ---» 
Miscellaneous devices ---> 
Hardware I/O ports ---> 


Xd 


图 10-2 ”配置 input 和 Event 接 


的 主要 


I 硬件 。 
. Input handler. Input handler 负责 


运行 make 


结构 包括 input dev. 


Linux 驱动 程序 开发 实例 第 2 版 


10.2.1 输入 设备 


input dev 结构 表示 一 个 输入 设备 ， 定 义 如 下 ; 


struct input dev { 
const char *name; 
const char *phys; /设备 在 系统 中 的 物理 路 径 
const char *uniq; /设备 唯一 识别 符 
struct input id id; /设备 ID， 包 含 总 线 ID (PCI，USB)、 三 商 ID 和 设备 人 D 
unsigned long propbit[BITS_ TO LONGS(INPUT PROP CNT)J; 
unsigned long evbit[BITS TO LONGS(EV. CNT)]; 
unsigned long keybit«BITS TO LONGS(KEY CNT)]; /支持 的 键盘 事件 
unsigned long relbit(«BITS TO LONGS(REL CNT)]; /支持 的 相对 值 事 件 
unsigned long absbit[BITS TO_LONGS(ABS_CNT)]; /支持 的 绝对 值 事件 
unsigned long mscbit[BITS TO LONGS(MSC CNT)]; 
unsigned long ledbit[«BITS TO LONGS(LED CNT)J; /支持 的 LED 事件 
unsigned long sndbit[BITS TO LONGS(SND CNT)J; 
unsigned long ffbit[BITS TO LONGS(FF. CNT)]; 
unsigned long swbit[BITS TO LONGS(SW CNT)]; 
unsigned int hint events per packet; 


pun 


unsigned int keycodemax; 

unsigned int keycodesize; 

void *keycode;//& 43: fid 

int (*setkeycode)(struct input dev *dev,const struct input keymap entry *ke,unsigned int *old keycode); 
int (*getkeycode)(struct input dev *dev,struct input keymap entry *ke); 
struct ff device *ff; 

unsigned int repeat key; 

struct timer list timer; 

int rep| REP. CNT]; 

struct input mt *mt; 

struct input absinfo *absinfo; 

unsigned long key[BITS TO LONGS(KEY CNT)]; 

unsigned long led[BITS TO LONGS(LED CNT)]J; 

unsigned long snd[BITS TO LONGS(SND CNT)]J; 

unsigned long sw[BITS TO LONGS(SW CNT)]; 

int (*open)(struct input dev *dev); 

void (*close)(struct input dev *dev); 

int (*flush)(struct input dev *dev, struct file *file); 

int (*event)(struct input dev *dev, unsigned int type, unsigned int code, int value);// 事 件 接口 
struct input handle — rcu *grab; 

spinlock t event lock; 

struct mutex mutex;/ 互 斥 锁 

unsigned int users; 

bool going away; 

struct device dev; 
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input dev 结构 的 evbit 成 员 表 示 设 备 支 持 的 事件 类 型 ， 可 以 是 下 列 值 的 组 合 : 


输 


10.2.2 


输 


输 


EV_SYN : 同步 事件 
色 对 二 进 制 值 ， 如 键盘 或 按钮 
对 结果 ， 如 鼠标 设备 
色 对 整数 值 ， 如 操纵 杆 或 书写 板 


EV KEY: 4 
EV REL: f| 
EV ABS: 2 
EV MSC: 其 他 类 


EV_SW: switch 事 


a 


EV_LED: LED 或 


他 指示 设备 


EV SND: 声音 输出 ， 如 蜂 鸣 器 
EV_REP: 允许 按键 自重 复 


EV_FF: 力 反 馈 


EV FF STATUS: 力 反 馈 状 态 


EV_PWR: 电 源 管理 事件 


入 设备 驱动 注册 与 


注销 函数 定义 如 下 : 


int input register device(struct input dev *dev); 


void input unregister device(struct input dev *dev); 


输入 事件 


limi 


入 事件 用 input event. 结构 描述 。 输 入 子 系统 中 内 核 与 应 用 层 交 互 的 基本 单位 是 
input event 结构 ， 定 义 如 


struct input event 


1 


T. 


struct timeval time;//I:] |R] ÆR 
. ul6 type;/ 驱 动 类 型 
. ul6 code;/ 事 件 码 


8s32 value;/ 事 件 值 


js 


入 设备 驱动 可 以 使 用 下 面 的 函数 向 输入 子 系统 报告 发 生 的 事件 : 


void input report key(struct input dev *dev, unsigned int code, int value); /键盘 事件 


void input report rel(struct input. dev *dev, unsigned int code, int value); /相对 值 


void input report abs(struct input. dev *dev, unsigned int code, int value); /绝对 值 


void input report ff status (struct input. dev *dev, unsigned int code, int value); // 力 有 反馈 状态 


void input report switch(struct input dev *dev, unsigned int code, int value); //switch 事件 


K 动 需要 使 用 input sync 函数 告诉 输入 子 系统 一 个 完整 的 报告 


static inline void input sync(struct input dev *dev) 


input event(dev, EV SYN, SYN REPORT, 0); 


在 事件 报告 完毕 后 ， 设 备 
已 经 发 送 。 
{ 
} 
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这 一 


点 在 鼠标 移动 处 理 


TH 


Hm 


中 很 重要 ， 因 为 鼠标 坐标 的 X 分 量 和 Y. 分 量 是 分 开 传送 的 ， 


要 利用 input sync 函数 来 同步 。 


10.2.3 


lin. 


Linux 核心 定义 了 一 个 Input Handler 链表 : 


input Handler 层 


Input Handler 层 负责 处 理 输入 事件 。 每 个 输入 设备 会 绑 定 一 个 或 多 个 Input Handler. 4 
入 设备 向 输入 子 系统 提交 的 事件 会 送 给 Input Handler 层 处 理 。 同 样 应 用 层 提 交 给 输入 节点 的 


和 件 也 先 送 给 Input Handler 层 处 理 ， 最 终 分 发 给 输入 设备 。 


struct input handler { 


je 


void *private; 
void (*event)(struct input handle *handle, unsigned int type, unsigned int code, int value);// 事 件 处 理 
/事件 序列 处 理 


void (*events)(struct input handle *handle,const struct input value *vals, unsigned int count); 


bool (*filter)(struct input handle *handle, unsigned int type, unsigned int code, int value); 
bool (*match)(struct input handler *handler, struct input dev *dev); 

// 绑 定 input handle 到 输入 设备 

int (*connect)(struct input handler *handler, struct input dev *dev, const struct input. device id *id); 
void (*disconnect)(struct input handle *handle); 

void (*start)(struct input handle *handle);// 启 动 函 数 ，connect 函数 之 后 调用 

bool legacy minors; 


int minor; 

const char *name; 

const struct input device id *id table; 
structlist head  h list; 

structlist head node; 


T 


static LIST HEAD(input handler list); 


input handler 的 注册 、 注 销 函 数 定义 如 下 : 


int input register handler(struct input handler *handler); 


void input unregister handler(struct input handler *handler); 


E 
Tir 


input register handler 函数 将 新 的 input handler 插入 到 input handler list 中 ， 并 将 其 绑 定 
到 相应 的 设备 上 : 
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int input register handler(struct input handler *handler) 


1 


struct input dev *dev; 
int error; 
error = mutex lock interruptible(&input mutex); 
if (error) 
return error; 
INIT LIST HEAD(&handler-h list); 


} 
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list add tail(&handler->node, &input handler list); 

list for each entry(dev, &input dev list, node) 
input attach handler(dev, handler); 

input wakeup procfs readers(); 

mutex unlock(&input mutex); 

return 0; 


input attach handler 函数 匹配 相应 的 输入 设备 ， 并 将 handle 与 设备 连接 起 来 : 


input handler 结构 的 一 个 重要 成 员 id table 为 input device id 结构 类 型 ， 


static int input attach handler(struct input dev *dev, struct input handler *handler) 


1 


j 


const struct input device id *id; 
int error; 
id = input match device(handler, dev); 
if (lid) 
return -ENODEV; 
error = handler-^connect(handler, dev, id); 
if (error && error != -ENODEV) 
pr err("failed to attach handler 96s to device %s, error: %d\n", 
handler->name, kobject name(&dev-^dev.kobj), error); 


return error; 


xu 


ip E 


input handler UG HORS] V EE: 


struct input device id { 


i 


kernel ulong t flags; 

. ul6 bustype; 

. ul6 vendor; 

. ul6 product; 

. ul6 version; 

kernel ulong t evbit[INPUT DEVICE ID EV MAX / BITS PER LONG - 1]; 
kernel ulong t keybit[INPUT DEVICE ID KEY MAX / BITS PER LONG + 1]; 
kernel ulong t relbit[INPUT DEVICE ID REL MAX /BITS PER LONG + 1]; 
kernel ulong t absbit[INPUT DEVICE ID ABS MAX /BITS PER LONG + 1]; 
kernel ulong t mscbit[INPUT DEVICE ID MSC MAX /BITS PER LONG + 1]; 
kernel ulong tledbit[INPUT DEVICE ID LED MAX /BITS PER LONG - 1]; 
kernel ulong t sndbit[INPUT DEVICE ID SND MAX / BITS PER LONG + 1]; 
kernel ulong t ffbit[I[NPUT DEVICE ID FF MAX/ BITS PER LONG + 1]; 
kernel ulong t swbit[INPUT DEVICE ID SW MAX / BITS PER LONG + 1]; 
kernel ulong t driver info; 


flag 设置 匹配 的 类 型 。input register device 函数 会 调用 input attach handler， 进 而 
调用 input match device 函数 为 输入 设备 驱动 匹配 input handler: 
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static const struct input device id *input match device(struct input handler *handlerstruct input dev *dev) 


1 


const struct input device id *id; 
for (id = handler-^id table; id->flags || id->driver info; id++) { 
if (id-^flags & INPUT DEVICE ID MATCH BUS) /匹配 总 线 类 型 
if (id-^bustype != dev-^id.bustype) 
continue; 
if (id-»flags & INPUT DEVICE ID MATCH VENDOR)V 匹 配 厂 商 
if (id-—vendor != dev--id.vendor) 
continue; 
if (id->flags & INPUT DEVICE ID MATCH PRODUCT) /匹配 第 
if (id->product != dev--id.product) 
continue; 
if (id-^flags & INPUT DEVICE ID MATCH VERSION) /匹配 版 本 
if (id->version != dev--id.version) 


IE 


造 商 


continue; 

if (Ibitmap subset(id->evbit, dev->evbit, EV MAXJ))/ 匹 配 事件 
continue; 

if (Ibitmap subset(id->keybit, dev->keybit KEY MAX)) 
continue; 

if (!bitmap subset(id-relbit, dev-^relbit, REL MAX)) 
continue; 

if (Ibitmap subset(id-^absbit, dev-^absbit, ABS MAX)) 
continue; 

if (bitmap subset(id-^mscbit, dev->mscbit, MSC MAX)) 
continue; 

if (bitmap subset(id--ledbit, dev->ledbit LED MAX)) 
continue; 

if (bitmap subset(id-^sndbit, dev->sndbit SND MAX)) 
continue; 

if (Ibitmap subset(id-^ffbit, dev->ffbit, FF MAX)) 
continue; 

if (bitmap subset(id-^swbit, dev-^swbit, SW MAX)) 
continue; 

if ('handler-^match || handler-^match(handler, dev)) 
return id; 


pun 


j 
return NULL; 


} 
input inject event 函数 用 于 从 input handle 发 
接口 会 处 理 这 个 事件 。 


牛 ， 而 输入 设备 (input dev) 的 event 


EE 
lip 
pur 
| 


void input inject event(struct input handle *handle,unsigned int type, unsigned int code, int value) 


10.2.4 常用 的 Input Handler 
evdev handler 是 Linux 内 核 中 通用 的 输入 设备 文件 处 理 接口 。 大 部 分 输入 子 系统 的 设备 
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均 会 匹配 到 evdev 对 应 的 设备 节点 ， 也 就 是 /dewinputevent0 ~ /dev/input/eventn. evdev 的 模 
块 初始 化 函数 为 evdev_init， 代 但 如 下 : 


static const struct input device id evdev lds[] = { 
{ .driver info = 1 },/* 匹配 所 有 输入 设备 */ 
{}, /* Terminating zero entry */ 
h 
MODULE DEVICE TABLE(input, evdev ids); 
static struct input handler evdev handler = { 
.event- evdev event, 
.events — evdev events, 
connect — evdev connect, 
.disconnect = evdev disconnect, 


legacy minors = true, 
minor - EVDEV MINOR BASE, 
.name- "evdev", 
Jd table = evdev 1ds, 
h 
static int — init evdev init(void) 
{ 
return input register handler(&evdev handler); 
j 
evdev ids 并 没有 设置 flag 域 ， 根 据 input match device 函数 的 结果 ， 它 是 匹配 所 有 输入 


设备 的 。 下 一 节 我 们 将 继续 分 析 evdev 设备 。 
mousedev handler 是 Linux 内 核 中 针对 鼠标 设备 的 处 理 接 口 。 鼠 标 设 备 既 有 绝对 值 事 件 
(CEV_REL)， 也 有 “点 击 ” 等 KEY 事件 CEV KEYO. 


static const struct input device id mousedev ids[] = ( 

{ 

.flags = INPUT DEVICE ID MATCH EVBIT |INPUT_DEVICE_ID_MATCH KEYBIT | 
INPUT DEVICE ID MATCH RELBIT, 

.evbit = ( BIT MASK(EV KEY)|BIT MASK(EV REL) ), 
keybit- { [BIT WORD(BTN LEFT)] = BIT MASK(BTN LEFT) ), 
relbit = ( BIT MASK(REL X)| BIT MASK(REL Y) }, 

ib /* A mouse like device, at least one button,two relative axes */ 


.flags = INPUT DEVICE ID MATCH EVBIT INPUT DEVICE ID MATCH RELBIT, 
.evbit = ( BIT MASK(EV KEY)|BIT MASK(EV REL) ), 
relbit = ( BIT MASK(REL WHEEL) ), 

},  f*Aseparate scrollwheel */ 


{}, /* Terminating entry */ 
h 
MODULE DEVICE TABLE(input, mousedev ids); 
static struct input handler mousedev handler = { 
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kbd handler 是 Linux 内 核 中 针对 键盘 的 处 理 接 
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.event= mousedev event, 


.connect 
disconnect 


legacy minors 


.minor 


EL 


.hame-— 


Jd tab 
jc 


— mousedev connect, 
— mousedev disconnect, 
= true, 
= MOUSEDEV MINOR BASE, 
mousedev", 
le — mousedev ids, 


static const struct input device id kbd ids[] = { 


1 


.flags = INPUT DEVICE ID MATCH EVBIT, 


.evbit = ( BIT MASK(EV. KEY) }, 


.flags = INPUT DEVICE ID MATCH EVBIT, 


.evbit = { BIT MASK(EV. SND) ), 


^ 


tds 
is 


/* Terminating entry */ 


MODULE DEVICE TABLE(input, kbd ids); 
static struct input handler kbd handler = ( 


.event= kbd event, 


match — kbd match, 
connect — kbd connect, 
.disconnect = kbd disconnect, 
.Start = kbd start, 
.name= "kbd", 

Jd table = kbd ids, 


js 


y 
Hr 


input leds handler 是 内 核 中 针对 LED 的 控制 接口 ， 可 用 于 标准 
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static const struct input device id input leds ids[|={ 


js 


1 


.flags - INPUT DEVICE ID MATCH EVBIT, 


.evbit = { BIT MASK(EV. LED) }, 


Us 


MODULE DEVICE TABLE(input, input leds ids); 
static struct input handler input leds handler = { 


.event =input leds event, 


.connect — —-input leds connect, 
disconnect =input leds disconnect, 


.name —"]eds", 


Kr 


TL 


的 LED $t 


W 


e—a 
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.jd table — —input leds ids, 


je 
标准 键盘 上 既 有 按键 ， 又 有 LED 灯 ， 两 者 是 如 何 关联 的 呢 ? 先 看 kbd handler 的 event 
接口 : 
void kbd event(struct input handle *handle, unsigned int event type,unsigned int event code, int value) 
{ 
spin lock(&kbd event lock); 
if (event type == EV MSC && event code == MSC RAW && HW RAW(handle->dev)) 
kbd rawcode(value); 
if(event type == EV KEY) 
kbd keycode(event code, value, HW RAW(handle-^dev)); 
spin unlock(&kbd event lock); 
tasklet schedule(&keyboard tasklet); 
do poke blanked console = 1; 
schedule console callback(); 
} 
kbd event 函数 启动 了 keyboard tasklet， 用 来 处 理 LED 状态 ， 具 体 实现 如 下 : 
static void kbd bh(unsigned long dummy) 
{ 
unsigned int leds; 
unsigned long flags; 
spin lock irqsave(&led lock, flags); 
leds = getleds(); 
leds |= (unsigned int)kbd->lockstate << 8; 
spin unlock irqrestore(&led lock, flags); 
if (leds != ledstate) 1 
kbd propagate led state(ledstate, leds);// 更 新 led 状态 
ledstate — leds; 
j 
j 
DECLARE TASKLET DISABLED(keyboard tasklet, kbd bh, 0); 
再 看 input leds handler 中 的 LED 控制 接口 ， 它 实际 上 注册 了 一 个 LED 类 设备 ， 具 体 代 
15 如 m 


int input leds connect(struct input handler *handlerstruct input dev *dev,const struct input. device id *id) 
{ 
for each set bit(led code, dev->ledbit LED CNT) { 
struct input led *led = &leds--leds[led no]; 
led--handle = &leds--handle; 
led->code = led code; 
if(linput led info[led code ].name)continue; 
led-^cdev.name = kasprintf(GFP. KERNEL, "%s::%s", 
dev name(&dev-»dev),nput led info[led code].name); 
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if (!led-^cdev.name) { 
error = -ENOMEM; 
goto err unregister leds; 
} 
led->cdev.max brightness = 1; 
led->cdev.brightness get= input leds brightness get; 
led-^cdev.brightness set = input leds brightness set; 
led-^cdev.default trigger = input led info[led code].trigger; 
error —led classdev register(&dev-^dev, &led-^cdev); 
if (error) { 
dev_err(&dev->dev, "failed to register LED 96s: %d\n",led->cdev.name, error); 
kfree(led-^cdev.name); 
goto err unregister leds; 


j 


led no; 


} 
假如 内 核 配 置 了 CONFIG INPUT LEDS 与 CONFIG LEDS TRIGGERS， 上 面 的 kbd 
propagate led state 函数 将 调用 led trigger event 通过 led 子 系统 调用 input leds.c 中 的 led 接 
O Cinput leds brightness set) 回 输入 设备 发 出 输入 事件 : 


p 


static void input leds brightness set(struct led classdev *cdev,enum led brightness brightness) 


1 
struct input led *led = container of(cdev, struct input led, cdev); 
input inject event(led-^handle, EV LED, led->code, !!brightness); 
} 


假如 内 核 没 有 配置 CONFIG INPUT LEDS 与 CONFIG LEDS TRIGGERS， 则 kbd - 
propagate led state 函数 将 直接 向 输入 设备 发 出 输入 事件 ; 


pi 


static int kbd update leds helper(struct input handle *handle, void *data) 


{ 
unsigned int leds = *(unsigned int *)data; 
if(test bit(EV LED, handle->dev->evbit)) ( 
input inject event(handle, EV LED, LED SCROLLL, !!(leds & 0x01)); 
input inject event(handle, EV LED, LED NUML, !!(leds & 0x02)); 
input inject event(handle, EV LED, LED CAPSL, !!(leds & 0x04)); 
input inject event(handle, EV SYN, SYN REPORT, 0); 
j 
return 0; 
} 
static void kbd propagate led state(unsigned int old state,unsigned int new state) 
{ 
input handler for each handle(&kbd handler, &new state,kbd update leds helper); 
j 
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10.3 输入 设备 应 用 层 


输入 子 系统 的 主 设备 号 为 INPUT _ MAJOR 。 应 用 程序 可 以 通过 通用 输入 设备 edev 的 


/dev/input/eventn 节点 向 输入 子 系统 发 送 数据 Cwrite) 或 接收 (read) 来 自 输入 子 系统 的 消息 ， 
过 IOCTL 命令 获取 驱动 的 能 力 与 支持 的 特 怕 


也 可 以 通 


第 10 章 MATAA 


evdev connect 函数 中 实现 : 


E。 通 用 输入 设备 edev 的 注册 过 程 在 


static int evdev connect(struct input handler *handler, struct input. dev *dev,const struct input device id *id) 


1 


struct evdev *evdev; 
int minor; 
int dev no; 


int error; 


minor = input get new minor(EVDEV MINOR BASE, EVDEV_MINORS, true);// 分 配 次 设备 


if (minor < 0) ( 
error — minor; 
pr err("failed to reserve new minor: %d\n", error); 
return error; 
j 
evdev = kzalloc(sizeof(struct evdev), GFP KERNEL); 
if (levdev) 1 
error = -ENOMEM; 
goto err free minor; 
j 
INIT LIST HEAD(&evdev-»client list); 
spin lock init(&evdev-»client lock); 
mutex init(&evdev-^mutex); 
init waitqueue head(&evdev--wait); 
evdev--exist = true; 
dev no = minor; 
h* 规范 化 设备 号 */ 
if (dev no < EVDEV MINOR BASE- EVDEV MINORS) 
dev no -= EVDEV MINOR BASE; 
dev set name(&evdev-»dev, "event%d", devy_n0);// 设 置 设备 名 称 
evdev->handle.dev = input get device(dev); 
evdev->handle.name = dev_name(&evdev->dev); 
evdev->handle.handler = handler; 
evdev->handle.private = evdev; 
evdev->dev.devt = MKDEV(INPUT MAJOR, minor); 
evdev->dev.class = &input class; 
evdev->dev.parent = &dev-^dev; 
evdev-»dev.release = evdev free; 
device initialize(&evdev-^dev); 


/号 


error = input_register_handle(&evdev->handle);// 注 意 不 是 input_register_handler 
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j 


if (error)goto err free evdev; 

edev init(&evdev-^cdev, &evdev fops); 

evdev-»cdev.kobj.parent = &evdev-»dev.kobj; 

error = edev add(&evdev-»cdev, evdev-»dev.devt, 1);// 添 加 字符 设备 
if (error)goto err unregister handle; 

error = device add(&evdev-»dev); 

if (error)goto err cleanup evdev; 

return 0; 


evdev fops H[l/dev/input/eventn 节点 的 文件 操作 接口 : 


以 evdev read 函数 为 例 说 明 输 入 设备 的 数据 读 取 有 具体 过 程 ， 
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static const struct file operations evdev_fops = { 


js 


.owner = THIS MODULE, 
read — evdev read, 

write = evdev write, 

.poll = evdev poll, 

.open — evdev open, 
release — evdev release, 
unlocked ioctl = evdev 1octl, 
.fasync = evdev fasync, 
.flush — evdev flush, 

.seek = no llseek, 


static ssize t evdev read(struct file *file, char — user *buffersize t count, loff t *ppos) 


1 


struct evdev client *client = file-^private data; 
struct evdev *evdev = client-»evdev; 
struct input event event; 
size t read = 0; 
int error; 
if (count != 0 && count < input event size())// 判 断 count 的 有 效 性 
return -EINVAL; 
for (;;) { 
if (evdev--exist || chent-^revoked) 
return -ENODEV; 
if (client-^packet head == client-^tail && 
(file->f flags & O NONBLOCK)) 
return -EAGAIN; 
if (count = 0)// 无 需 继续 
break; 
while (read + input_event size() <= count && 
evdev fetch next event(client, &event)) {// 获 取 下 一 个 事件 


if (input event to user(buffer + read, &evenb)/ 向 用 户 空 间 复制 数 ] 


HI 


return -EFAULT; 
read += input event size(); 
} 
if (read)break; 
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让 (!(file->f flags & O NONBLOCK)) {// 判 断 是 否 为 阻塞 式 
error = wait event interruptible(evdev->wait,client->packet head != client->tail || 


levdev--exist || client-^revoked); 
if (error)return error; 


j 


return read; 


j 


input event to user 函数 调用 了 copy to user 函数 向 应 用 层 
个 input event: 


intinput event to user(char user *buffer,const struct input event *event) 


1 
if(copy to user(buffer, event, sizeof(struct input event)))return 
return 0; 


j 


(5110.1 输入 子 系统 IOCTL 实例 
本 例 演示 输入 设备 的 几 个 简单 的 ioctl 接口 ， 参 考 代 码 如 下 : 


int version; 

int fd = open("/dev/input/event1", O RDONLY); 
ioctl(fd, EVIOCGVERSION, &version); /获取 版 本 
struct input devinfo device info; 

ioctl(fd, EVIOCGID, &device info); /获取 设备 信息 
char name[256]- "Unknown"; 

ioctl(fd, EVIOCGNAME(sizeof(name)), name)//3X BU T 
uint8 trel bitmask[REL MAX/8 + 1]; 


ioctl(fd, EVIOCGBIT(EV REL, sizeof(rel_bitmask))// 获 取 支 持 的 鼠标 特性 


10.4 ”键盘 输入 设备 驱动 程序 实例 


13] 10.2 S3C6410X 键盘 输入 驱动 程序 
代码 见 \samples\10input\10-1Button。 这 里 针对 第 6 章 的 键盘 
的 驱动 程序 。 核 心 代码 如 


7 b 


static struct input dev*simplekey dev; 

static unsigned long polling jffs=0; 

static char *simplekey name = "simplekey"; 

static char *simplekey phys — "input0"; 

static unsigned char simplekey keycode[0x06] = { 


-EFAULT; 


t 


电路 编写 


个 输入 设备 形式 
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[0]- KEY L[1]- KEY 2,[2]- KEY 3, 
[3]- KEY 4[4]- KEY 5,[5]- KEY 6, 
h 
static unsigned char offset[]- (Ox3E,0x3D,0x3B,0x37,0x2E,0x1F] ; 
static int irqArray[6]- 
1 
S3C BINT(0),S3C EINT(1),S3C EINT(2), 
S3C EINT(3),S3C EINT(4),S3C EINT(5) 
h 
#define eint. offset(irq) ((irg) - IRO EINT(0)) 
#define eint irq to bit(irq) (1 << eint offset(irq)) 
static void s3c irq eint unmask(unsigned int irq) 


1 
u32 mask; 
mask- raw readl((S3C64XX EINTOMASK); 
mask &- -(eint irq to bit(irq)); 
. raw writel(mask, S3C64XX EINTOMASK); 
j 


/设置 中 断 类 型 
static int s3c irq eint set type(unsigned int irq, unsigned int type) 
1 
int offs — eint. offset(irq); 
int shift; 
u32 ctrl, mask; 
u32 newvalue = 0; 
void  iomem *reg; 
If (offs > 27)return -EINVAL; 
if (offs > 15) 
reg = S3C64XX EINTOCONI; 
else 
reg = S3C64XX EINTOCONO; 
switch (type) { 
case IRQ TYPE NONE: 
printk(KERN WARNING "No edge setting!\n"); 
break; 
case IRQ TYPE EDGE RISING: 
newvalue = $3C2410 EXTINT RISEEDGE; 
break; 
case IRQ TYPE EDGE FALLING: 
newvalue = $3C2410 EXTINT FALLEDGE; 
break; 
case IRQ TYPE EDGE BOTH: 
newvalue = $3C2410 EXTINT BOTHEDGE; 
break; 
case IRQ TYPE LEVEL LOW: 
newvalue = $3C2410 EXTINT LOWLEV; 


Fa 


break; 
case IRQ TYPE LEVEL HIGH: 

newvalue = S3C2410 EXTINT HILEV; 

break; 
default: 

printk(KERN ERR "No such irq type %d", type); 

return -1; 
} 
shift = ((offs % 16) / 2) * 4; /* org: shift = (offs / 2) * 4; */ 
mask = 0x7 «« shift; 
ctl - raw readl(reg); 
ctrl &= ~mask; 
ctrl |= newvalue << shift; 
. raw writel(ctrl, reg); 
if (offs « 16) 

s3c gpio cfgpin(S3C64XX GPN(offs), 0x2 << (offs * 2)); 
else if (offs « 23) 

s3c gpio cfgpin(S3C64XX GPL(offs - 8, S3C GPIO SEN(3)); 
else 

s3c gpio cfgpin(S3C64XX GPM(offs - 23), S3C GPIO SFN(3)); 
return 0; 


j 
void set pin Interrupt(int iflag) 
{ 
if(iflag) 
1 
s3c gpio cfgpin(S3C64XX GPN(0),53C64XX GPNO EINTO); 
s3c gpio cfgpin(S3C64XX GPN(1),S3C64XX GPNI EINTI1); 
s3c gpio cfgpin(S3C64XX GPN(2)3C64XX GPN2 EINT2); 
s3c gpio cfgpin(S3C64XX GPN(3),S3C64XX GPN3 EINT3); 
s3c gpio cfgpin(S3C64XX GPN(4),S3C64XX GPN4 EINT4); 
s3c gpio cfgpin(S3C64XX GPN(5),53C64XX GPNS EINT5); 
j 
else 
1 
s3c gpio cfgpin(S3C64XX GPN(0),0); 
s3c gpio cfgpin(S3C64XX GPN(1),0); 
s3c gpio cfgpin(S3C64XX GPN(2),0); 
s3c gpio cfgpin(S3C64XX GPN(3),0); 
s3c gpio cfgpin(S3C64XX GPN(4),0); 
s3c gpio cfgpin(S3C64XX GPN(5),0); 
j 
j 
/按键 GPIO 设置 
void initButton(void) 
{ 
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j 


set pin Interrupt(1); 


s3c gpio setpull(S3C64XX GPN(0), SAC GPIO PULL NONE); 
s3c gpio setpull(S3C64XX GPN(1) S3C GPIO PULL NONE); 
s3c gpio setpull(S3C64XX GPN(2) S3C GPIO PULL NONE); 
s3c gpio setpull(S3C64XX GPN(3), SAC GPIO PULL NONE); 
s3c gpio setpull(S3C64XX GPN(4) S3C GPIO PULL NONE); 
s3c gpio setpull(S3C64XX GPN(5), SAC GPIO PULL NONE); 
S3c irq eint set type(0, IRO TYPE EDGE FALLING); 
S3c irq eint set type(1, IRQ_ TYPE EDGE FALLING); 
S3c irq eint set type(2, IRQ TYPE EDGE FALLING); 
S3c irq eint set type(3, IRQ_ TYPE EDGE FALLING); 
S3c irq eint set type(4, IRQ TYPE EDGE FALLING); 
S3c irq eint set type(5, IRQ TYPE EDGE FALLING); 


S3c irq eint unmask(0); 
S3c irq eint unmask(1); 
S3c irq eint unmask(2); 
S3c irq eint unmask(3); 
S3c irq eint unmask(4); 
S3c irq eint unmask(5); 


void polling handler(unsigned long data) 


1 


u32 code-0; 

int i-0; 

code= raw readl(S3C64XX GPNDAT); 
code-code&Ox3F; 

if(code>0) 

{ 


/避免 中 断 连续 出 现 
if((jiffies-polling jffs)>100) 
1 
polling jffs-jiffies; 
for(i=0;i<6;i++) 


{ 
if(offset[i]==code) 
{ 
code=i; 
} 
} 


pun 


ITF P RC CREE 


input report key(simplekey dev, simplekey keycode[code], 1) 
input report key(simplekey dev, simplekey keycode[code], 0) 


input sync(simplekey dev); 


j 


set pin Interrupt(1); 


$ 
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j 
/使 用 tasklet 处 理 中 断后 半 部 
DECLARE TASKLET(test tasklet;polling handler, (unsigned long) &simplekey dev); 
static irqreturn t simplekey interrupt(int irq, void *dummy) 
1 

set pin Interrupt(0); 

tasklet schedule(&test tasklet); 

return IRO HANDLED; 
} 
static int init simplekey init(void) 
{ 

int i=0; 

initButton(); 

simplekey dev-input allocate device(); 

for (i = 0; i <6; i++) 

{ 

if (request irq(irqArray[1], &simplekey interrupt, 0, "simplekey", NULL)) 
i 
printk("request button irq failed!n"); 
return -1; 


j 


printk("initialize button ...n"); 
simplekey dev--evbit[0] = BIT(EV KEY); 
simplekey dev-^keycode = simplekey keycode; 
simplekey dev--keycodesize = sizeof(unsigned char); 
simplekey dev--keycodemax = ARRAY SIZE(simplekey keycode); 
for (i = 0; i < 0x78; i++) 
if (simplekey keycode[i]) 
set bit(simplekey keycode[i], simplekey  dev--keybit); 
simplekey dev-^name = simplekey name; 
simplekey dev->phys = simplekey phys; 
simplekey dev--id.bustype = BUS AMIGA; 
simplekey dev--id.vendor = 0x0001; 
simplekey dev->id.product = 0x0001; 
simplekey dev--id.version = 0x0100; 
input register device(simplekey dev); 
printk("initialize button ok! n"); 
return 0; 
} 
static void _ exit simplekey exit(void) 
{ 
int i; 
for (i = 0; 1 «6; i++) 
1 
free irq(irgArray[1, NULL); 
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j 


input unregister device(simplekey dev); 


j 
module init(simplekey init); 
module exit(simplekey exit); 


应 用 层 测试 代码 如 下 : 


void main() 
{ 
int fd= -1; 
char name[256]= "Unknown"; 
int yalv; 
if ((fd = open("/dev/input/event1", O RDONLY)) < 0) { 
perror("evdev open"); 
exit(1); 
j 
if(ioctl(fd, EVIOCGNAME(sizeof(name)), name) < 0) ( 
perror("evdev ioctl"); 
j 
size t rb; 
struct input event ev[2]; 
while(1) 
{ 
rb=read(fd,ev,sizeof(struct input event)*2); 
if (rb < (int) sizeof(struct input event)) 
{ 
perror("evtest: short read"); 
exit (1); 
j 
for (yalv = O;yalv < (int) (rb / sizeof(struct input. event));yalv-—-) 
{ 
if (EV_KEY == ev[yalv].type) 
i 
printf("time:%ld.%06ld (s)  ",ev[yalv].time.tv sec,ev[yalv].time.tv usec); 
printf("type %d code %d value %d\n",ev[yalv].type,ev[yalv].code,ev[yalv]. 
value); 


close(fd); 
} 


本 例 测试 结果 如 下 : 


[root(Qurbetter /homel# insmod button.ko 
initialize button ... 


input: simplekey as /class/input/input3 
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initialize button ok! 


[root(Q)urbetter /homel# ./demotest 


time:1086222460.263859 (s) 
time:1086222460.263878 (s) 
time:1086222461.898843 (s) 
time:1086222461.898863 (s) 
time:1086222464.753842 (s) 
time:1086222464.753861 (s) 
time:1086222466.788851 (s) 
time:1086222466.788870 (s) 
time:1086222469.023849 (s) 
time:1086222469.023868 (s) 
time:1086222470.133852 (s) 
time:1086222470.133871 (s) 


type 1 code 5 value 1 
type 1 code 5 value 0 
type 1 code 2 value 1 
type 1 code 2 value 0 
type 1 code 3 value 1 
type 1 code 3 value 0 
type 1 code 4 value 1 
type 1 code 4 value 0 
type 1 code 6 value 1 
type 1 code 6 value 0 
type 1 code 7 value 1 
type 1 code 7 value 0 
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10.5 Event 接口 实例 


input dev 结构 有 一 个 重要 的 成 员 ， 就 是 event 接口 。 


int (*event)(struct input dev *dev, unsigned int type, unsigned int code, int value); 
本 节 以 一 个 实例 形式 介绍 这 个 接口 的 使 用 。 
例 10.3 LED 输入 事件 处 理 实例 
电路 原理 见 第 6 章 。 代 人 码 见 samples\10input\10-2event。 核 心 代码 如 下 : 


#define LED SI H(i) raw writel( raw readl(S3C64XX GPMDAT)/(1««1),S3C64XX GPMDAT) 
#define LED SI L(i) raw writel( raw readl(S3C64XX GPMDAT)&(-(1««1),S3C64XX GPMDAT) 
static char s3c6410 LED name[] = "53c6410LED"; 

static char s3c6410 LED phys[] = "s3c6410LED"; 

static struct input dev* s3c6410 LED dev; 

//event 接口 函数 

static int s3c6410 LED event(struct input dev *dev, unsigned int type, unsigned int code, int value) 


1 


printk("s3c6410 LED event type%d value%d\n",type,value); 
if (type != EV LED)returm -1; 
switch(value) 
{ 
case 0: 
LED SI L(0); 
break; 
case 1: 
LED SI H(0); 
break; 


return 0; 
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static int init S3c6410 LED init(void) 

1 
LED SI OUTI; 
S3c6410 LED dev-input allocate device(); 
s3c6410 LED dev->evbit[0] = BIT(EV LED); 
s3c6410 LED dev--ledbit[0] = BIT(LED NUML); 
$3c6410 LED dev--event = $3c6410 LED event; 
s3c6410 LED dev->name = s3c6410 LED name; 
s3c6410 LED dev->phys = s3c6410 LED phys; 
s3c6410 LED dev--id.bustype = BUS HOST; 
s3c6410 LED dev--id.vendor = 0x001£f 
s3c6410 LED dev--id.product = 0x0001; 
S3c6410 LED dev--id.version = 0x0100; 
/注册 LED 输入 设备 
input register device(s3c6410 LED dev); 
printk(KERN INFO "input: %s\n", S3c6410 LED name); 
return 0; 


j 


static vold — exit sS3c6410 LED exit(void) 


1 
input unregister device(s3c6410 LED dev); 


) 
应 用 层 通过 /dewinputeventl 控制 LED 灯 。 注 意 这 里 的 打开 标志 设置 成 O WRONL Y. 


void main() 
1 
int fd = -1; 
char name[256]- "Unknown"; 
int yalv; 
if ((fd = open("/dev/input/event1", O WRONLY)) « 0) { 
perror("evdev open"); 
exit(1); 
j 
if(ioctl(fd, EVIOCGNAME(sizeof(name)), name) < 0) { 
perror("evdev ioctl"); 
} 
size trb; 
/构建 事件 
struct input event ev[2]; 
ev[0].type-EV LED; 
ev[0].code-LED NUML; 


[ 
ev[0].value—-0; 
ev[1].ype-EV LED; 
ev[1].code-LED NUML; 
ev[1].value-1; 

while(1) 
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rb—write(fd,ev,sizeof(struct input event)); 
if (rb < (int) sizeof(struct input event)) 
1 
perror("evtest: short write"); 
exit (1); 
} 
sleep(1); 
rb—write(fd,&ev[1],sizeof(struct input event)); 
if (rb < (int) sizeof(struct input event)) 
1 
perror("evtest: short write"); 
exit (1); 
} 
sleep(1); 
} 
close(fd); 
} 


当 应 用 层 调用 write 函数 ， 进 入 内 核 中 将 会 调用 evdev_write 函数 : 


static ssize t evdev write(struct file *file, const char — user *buffersize t count, loff t *ppos) 
1 
struct evdev client *client = file-^private data; 
struct evdev *evdev = client-^evdev; 
struct input event event; 
int retval = 0; 
if (count != 0 && count < input event size()) 
return -EINVAL; 
retval = mutex lock interruptible(&evdev-^»mutex); 
if (retval) 
return retval; 
if (levdev->exist || client->revoked) { 
retval = -ENODEV; 
goto out; 
j 
while (retval + input event size() «— count) ( 
if (input event from user(buffer + retval, &event)) ( 
retval = -EFAULT; 
goto out; 
j 
retval += input event size(); 
input inject event(&evdev--handle,event.type, event.code, event.value); 


out: 


mutex unlock(&evdev-^mutex); 
return retval; 
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input inject event. Kt JH] f input handle event PK, input handle event 函数 定义 
如 下 : 


static void input handle event(struct input dev *dev,unsigned int type, unsigned int code, int value) 
{ 
int disposition; 
disposition = input get disposition(dev, type, code, &value); 
if ((disposition & INPUT PASS TO DEVICE) && dev--event) 
dev--event(dev, type, code, value);// 调 用 设备 的 事件 接口 
if (!dev->vals) 
return; 
if (disposition & INPUT PASS TO HANDLERS) { 
struct input. value *v; 
if (disposition & INPUT SLOT) { 
v = &dev-»vals[dev-^num vals++]; 
v->type = EV ABS; 
v-»code = ABS MT SLOT; 
v-»value = dev->mt->slot; 
j 
v = &dev-»vals[dev-^num vals--]; 
V->type = type; 
v-»code = code; 
v-»value = value; 
} 
if (disposition & INPUT FLUSH) { 
if (dev->num vals >= 2) 
input pass values(dev, dev--vals, dev-^num vals); 
dev-^num vals = 0; 
} else if (dev->num vals >= dev->max vals - 2) { 
dev->vals[dev->num vals++] = input value sync; 
input pass values(dev, dev--vals, dev-^num vals); 


dev-^num vals = 0; 


j 


可 见 内 核 会 自动 调用 s3c6410 LED event 函数 。 加 载 这 个 驱动 ， 并 运行 应 用 程序 就 能 看 
到 LED NK: 


[root@urbetter drivers | insmod demo.ko 

input: S3c6410LED as /devices/virtual/input/input1 
input: s3c6410LED 

[root(a)urbetter drivers |? ./test 

S3c6410 LED event typel7 valuel 

S3c6410 LED event type17 value0 

S3c6410 LED event typel7 valuel 

S3c6410 LED event type17 value0 

S3c6410 LED event typel7 valuel 
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SC 


[root@urbetter drivers]# 


10.6 ”触摸 屏 驱 动 程序 实例 


Linux 中 的 触摸 屏 双 


驱动 程序 ， 可 以 作为 一 种 普通 的 字符 型 设备 ， 


的 框架 


。 触 摸 屏 与 鼠标 的 最 大 


味 着 在 应 用 层 使 用 触摸 屏 驱 动 程序 必须 


x d 


LAT E 


也 可 以 纳入 输 


10.6.1 S3C6410X 触摸 屏 控制 器 


S3C6410X 又 


XM. XP. YM, YP 


VDDA ADC 
o 


AIN7(XP) Q 


持 触摸 屏 接口 ， 


四 根 信 


PULL UP 
XM. SEN 
YM SEN 
XP SEN 

YP SEN 


AIN&(XM) [] 


AINS(YP) Q 


AINS(YM) [] 


AIN5(3:0) [7] 


触摸 屏 接口 有 四 个 工作 模式 ， 依 ADCTSC 寄存 器 的 AUTO_PST 和 XY PST ffi 


E 于 前 者 是 基于 绝对 坐标 ， 而 后 者 是 基于 相对 多 
先进 行 校准 


它 是 与 ADC 转换 器 共用 的 。S3C6410X 的 触摸 屏 接 口 
号 线 。 图 10-3 是 S3C6410X 的 触摸 


ADC input 
control 


Hiro XÈ 


o 


包括 


接口 原理 图 。 


Touch screen 
pads control 


ADC 
imterface 
A/D 
Converter 


Touch 
screen 
control 


INT_ADC 


Interrupt 
generation |INT_PNDNUP 


Waiting for interrupt 


工作 模式 的 比较 见 表 10-1。 


图 10-3 S3C6410X 的 触摸 


"Hin 


定 。 四 个 


表 10-1 四 个 工作 模式 
模 A AUTO PST XY PST 说 — Hj 
常规 转换 模式 AUTO PST-0 XY PST-0 通用 的 ADC 转换 
i XY PST-1 转换 X 坐标 到 ADCDATO 的 XPDATA， 并 产生 INT ADC 
AA y Alt S. E um " 
dt AMI | AUTO PsT=0 中 断 
VERD XY PST-2 转换 Y 坐标 到 ADCDATI1 的 YPDATA 并 产生 INT ADC 中 断 
XY 坐标 自动 转 " 动 转换 X 坐标 到 ADCDATO 的 XPDATA; 同时 转换 v A^ 
换 模式 "EET FRI 标 到 ADCDATI1 的 YPDATA; 并 产生 INT ADC 中 断 
等 待 中 断 模式 XY PST-3 当 触 摸 笔 点 击 时 产生 中 断 ， 产 生 INT PNDNUP 中 断 信号 


S3C6410X 中 与 触摸 屏 相 关 的 寄存 器 见 表 10-2 一 表 10-6. 
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Bit 


表 10-2 ADCON 寄存 器 


Hi 


初始 值 


RESSEL 


[16] 


AD 转换 分 激素 这 择 
0=10bit; 1=12bit 


0 


ECFLG 


[15] 


AD 转 VIZ SET 下 志 
0=AD 转换 进行 中 
1=AD 转换 结束 


PRSCEN 


[14 


AD 转换 预 分 频 器 使 能 
0= 停 止 ;1= 使 能 


PRSCVL 


[13:6] 


AD 转换 预 分 频 器 数值 

范围 ，5~255 

除数 为 (PRSCVL+1) 

注意 ADC 频率 应 该 设置 成 小 于 PCLK 的 5 倍 


OxFF 


SEL MUX 


[5:3] 


模拟 输入 通道 选择 

000=AIN0 001=AIN1 
010=AIN2 011=AIN3 
100=YM — 101- YP 
110-XM 111=XP 


STDBM 


[2] 


Standby 模式 选择 
0--- 普 通 模式 
1---standby 模式 


READ START 


[1] 


通过 读 取 来 启动 AD 转换 
0--- 停 止 通过 读 取 来 启动 AD 转换 
1--- 使 能 通过 读 取 来 启动 AD 转换 


ENABLE START 


ADCTSC 


[0] 


启动 AD 操作 。 
如 果 READ_START=1， 则 这 个 值 无 效 
0= 无 操作 


l= 启动 AD 转换 ， 启 动 后 该 位 清 零 


表 10-3 ADCTSC 寄存 器 


初始 值 


Reserved 


保留 5 


0 


UD SEN 


触摸 笔 按 下 与 弹 起 状态 检测 
0= 检 测 触 摸 笔 按 下 中 断 
1= 检 测 触 摸 笔 弹 起 中 断 


YM SEN 


选择 YMON 的 输出 值 
YMON 输出 0(YM-Hi-Z) 
YMON 输出 (YM-GND) 


YP SEN 


选择 nYPON 的 输出 值 
0---nYPON 输出 0(YP=External voltage) 


XM SEN 


ua 

ELF 

1---nYPON 输出 1(YP 连接 AIN[S]) 
选择 XMON 的 输出 值 

0---XMON 输出 0XM=Hi Z) 
1---XMON 输出 1(XM=GND) 


XP SEN 


选择 nXPON 的 输出 值 
0---nXPON 输出 0(XP=External voltage) 
1---nXPON 输出 1(XP 连接 AIN[7]) 


PULL UP 


ERIA 
0--- 人 允许 XP | 
1--- 禁 止 XP | 


B 
x 


tr H 


AUTO PST 


模式 选 i 
0--- 正 常 ADC 转换 
1--- 自 动 XY 坐标 转换 


XY PST 
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[1:0] 


测量 模式 
00--- 无 操作 
01---X 坐标 测量 
10---Y 坐标 测量 
11--- 等 待 中 断 模式 


第 10 章 输入 子 系统 
表 10-4 ADCDLY 寄存 器 
ADCDLY Bit Ho R 初始 值 
FILCLKsrc [16] ADCDLY 时 钟 源 选 择 
常规 转换 模式 、XY 坐标 自动 转换 模式 、XY 坐标 自动 转换 模 
式 下 X/Y 坐标 转换 延 时 
iix 等 待 中 断 模 起 下， 触摸 笔 按 下 以 后 产生 中 断 的 时 间 间隔 dnd 
注意 不 能 使 用 0 值 。 
4310-5 ADCDATO0 寄存 器 
ADCDATO Bit Jo x 初始 值 
等 待 中 断 模式 下 触摸 笔 状 态 
UPDOWN [15] 0---- 触 摸 笔 按 下 
0--- 常 规 ADC 转换 
AUTORAI [14] 1—XY 坐标 顺序 测量 
00--- 无 操作 
. 01---X 坐标 测量 
人 [13:121] 10---Y 坐标 测量 
11--- 等 待 中 断 模式 
XPDATA 12 [11:10] 当 采 样 分 辩 率 为 12bit 时 作 X 坐标 高 位 使 
XPDATA [9:0] X 坐标 值 或 常规 ADC 转换 值 ， 支 持 到 0x3f 
表 10-6 ADCDATI 寄存 器 
ADCDATI Bit do x 初始 值 
等 待 中 断 模式 下 触摸 笔 状 态 
UPDOWN [15] 0---- 触 摸 笔 按 下 
1---- 触 摸 笔 拿 起 
0--- 常 规 ADC 转换 
AUTOLEST [14] 1—XY 坐标 顺序 测量 
00--- 无 操作 
01---X 坐标 测量 
APSL [13:12] 10---Y 坐标 测量 
11--- 等 待 中 断 模式 
YPDATA 12 [11:10] 当 采 样 分 辨 率 为 12bit 时 作 Y 坐标 高 位 使 
YPDATA [9:0] Y Abl. SEREF Ox3ff 


10.6.2. S3C6410X 触摸 屏 驱 动 程序 


当 触 措 


IRQ ADC 为 4 


屏 有 数据 时 ，S3C6410X rA 


标 或 者 AD 转换 ， 


S3C6410X 的 触摸 


Wi, IRQ PENDN 为 触摸 点 击 


屏 资 源 结构 ， 定 义 如 下 : 


#define IRQ_ADC 
#define IRQ PENDN 


S3C64XX IRQ VIC1(31) 
S3C64XX IRQ VIC1(30) 


static struct resource s3c ts resource[]={ 
[0] - 1 
start = S3C PA ADC, 


.end 


=S3C PA ADC+SZ 4 区 -1， 


.flags = IORESOURCE MEM, 


E 两 个 中 断 ， 分 别 是 IRQ ADC 和 IRQ PENDN, 


Wr. s3c ts resource 为 
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h 
Ds 
.start = IRQ PENDN, 
.nd | -IRQ PENDN, 
.flags - IORESOURCE IRQ, 
b 
[2]- 1 
start -IRQ ADC, 
.end =IRQ ADC, 
flags = IORESOURCE IRQ, 
j 


lis 
注册 一 个 平台 驱动 : 


ny 
Mr 


static struct platform driver s3c ts driver = ( 


.probe = s3c ts probe, 
remove = s3c ts remove, 
Suspend = s3c ts suspend, 
resume =S3c ts resume, 
.driver ={ 
.owner = THIS MODULE, 
.name -"s3c-ts", 
j nA 
H 
static int — inits3c ts init(void) 
{ 
return platform driver register(&s3c ts driver); 
j 
static void — exit s3c ts exit(void) 
{ 
platform driver unregister(&s3c ts driver); 
j 


s3c ts probe 函数 代码 如 下 : 


static int — init s3c_ ts probe(struct platform device *pdev) 
{ 
struct resource *res; 
struct device *dev; 
struct input. dev *input dev; 
struct s3c ts mach info * s3c ts cfg; 
int ret, size; 
dev = &pdev-^dev; 
res = platform get resource(pdev, IORESOURCE MEM, 0);/3kHX IO 资源 
if (res = NULL) 1 
dev err(dev,"no memory resource specified n"); 
return -ENOENT; 
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j 


size = (res->end - res-»start) + 1; 


ts mem = request mem region(res->start, size, pdev->name);// 申 请 内 存 区 
if(ts mem == NULL) { 

dev err(dev, "failed to get memory region"); 

ret - -ENOENT; 

goto err req; 


j 

ts base = ioremap(res-»start, size);// 地 址 映射 

if (ts base — NULL) ( 
dev err(dev, "failed to ioremap() regionn"); 
ret = -EINVAL; 


goto err map; 


} 
ts clock = clk get(&pdev->dev, "adc"); 
if(IS ERR(ts clock)) { 
dev err(dev, "failed to find watchdog clock source"); 
ret = PTR. ERR(ts clock); 
goto err clk; 
} 
clk_enable(ts_clock);// 使 能 时 钟 
s3c ts cfg = s3c ts get platdata(&pdev->dev); 
if((s3c ts cfg-^presc&Oxff) > 0) 
wiitel(S3C ADCCON PRSCEN | 
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S3C ADCCON PRSCVL(S3c ts cfg-^presc&OxFF),ts base-S3C ADCCON); 


else 
writel(0, ts base+S3C ADCCON); 
P* 初始 化 寄存 器 */ 
if ((s3c ts cfg-^delay&Oxffff) > 0) 
writel(s3c ts cfg->delay & Oxffff, ts base-S3C ADCDLY); 
if(s3c ts cfg->resol bit==12) { 
/根据 ADC 类 型 进行 设置 ， 不 同 的 类 型 对 应 的 寄存 器 定义 不 同 
switch(s3c ts cfg-^s3c adc con) { 
case ADC TYPE 2: 


writel(readl(ts base+S3C ADCCON)|S3C ADCCON RESSEL 12BIT, 


ts base-S3C ADCCON); 
break; 
case ADC TYPE 1: 


writel(readl(ts base+S3C ADCCON)|S3C ADCCON RESSEL 12BIT 1, 


ts base-S3C ADCCON); 
break; 
default: 


dev err(dev, "Touchscreen over this type of AP isn't supported ! An"); 


break; 
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writel(WAITA4INT(0), ts_base+S3C ADCTSC); 
ts = kzalloc(sizeof(struct s3c ts info), GFP KERNEL); 
input dev — input allocate device(); 
if (input dev) ( 

ret --ENOMEM; 

goto err alloc; 
j 
ts->dev = input dev; 
ts->dev->evbit[0] = ts->dev->evbit[0] = BIT MASK(EV SYN)| 

BIT MASK(EV KEY)|BIT MASK(EV_ABS);// 支 持 的 事件 类 型 

ts->dev->keybit[BIT WORD(BTN TOUCH)]- BIT MASK(BTN_TOUCH);// 按 键 类 型 
if(s3c ts cfg->resol bit==12) { 

input set abs params(ts->dev, ABS X, 0, OxFFF, 0, 0); 

input set abs params(ts-^»dev, ABS Y, 0, OxFFF, 0, 0); 


j 
else { 
input set abs params(ts-^»dev, ABS X, 0, Ox3FF, 0, 0); 
input set abs params(ts-^»dev, ABS Y, 0, Ox3FF, 0, 0); 
j 


input set abs params(ts-^dev, ABS PRESSURE, 0, 1, 0, 0); 
sprintf(ts->phys, "input(ts)"); 
ts->dev->name = s3c ts name; 
ts->dev->phys = ts-^phys; 
ts->dev->id.bustype = BUS RS232; 
ts->dev->id.vendor = OXDEAD; 
ts->dev->id.product = OXBEEF; 
ts->dev->id.version = S3C TSVERSION; 
ts->shift = s3c ts cfg-^oversampling shift; 
ts-^resol bit = s3c ts cfg->resol bit; 
ts-^s3c adc con s3c ts cfg-^s3c adc con; 
/* IRQ PENDUP 中 断交 
ts irq = platform get resource(pdev, IORESOURCE IRQ, 0); 
if (ts irq — NULL) ( 
dev err(dev, "no irq resource specified"); 


ret - -ENOENT; 
goto err irq; 
j 
ret = request irq(ts irq-^start, stylus updown, IROF SAMPLE RANDOM "s3c updown", ts); 
if (ret != 0) ( 
dev err(dev,"s3c ts.c: Could not allocate ts IRQ PENDN !n*); 
ret — -EIO; 
goto err irq; 
} 


/* IRQ ADC 'flljp**/ 
ts irq = platform get resource(pdev, IORESOURCE IRQ, 1); 
if (ts irq == NULL) ( 


258 


第 10 章 输入 子 系统 


dev err(dev, "no irq resource specified"); 


ret - -ENOENT; 
goto err irq; 
j 
ret - request irq(ts irq-^start, stylus action, IROF SAMPLE RANDOM, "s3c action", ts); 
if (ret != 0) ( 
dev err(dev, "s3c ts.c: Could not allocate ts IRO ADC !n"); 
ret= -EIO; 
goto err irq; 
j 


printk(KERN INFO "%s got loaded successfully : %d bits", s3c ts name, s3c ts cfg-^resol bit); 
MEA ee 
ret = input register device(ts-^dev); 
if(ret) { 
dev err(dev, "s3c ts.c: Could not register input device(touchscreen)! n"); 
ret — -EIO; 
goto fail; 


} 
return 0; 
fail: 
free irq(ts_irq->start, ts->dev); 
free_irq(ts_irq->end, ts->dev); 
err irq: 
input free device(input dev); 
kfree(ts); 
err alloc: 
clk disable(ts clock); 
clk put(ts clock); 
err clk: 
jounmap(ts base); 
err map: 
release resource(ts mem); 
kfree(ts mem); 
err req: 
return ret; 


} 
两 个 中 断 处 理 函 数 定义 如 下 : 


static irqreturn t stylus updown(int irqno, void *param) 
1 
unsigned long data0; 
unsigned long datal; 
int updown; 
data0 = readl(ts base-S3C ADCDATO); 
datal = readl(ts base S3C ADCDATT); 
updown = (!(data0 & S3C ADCDATO UPDOWN)) && (!(datal & S3C ADCDATI UPDOWN)); 
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让 (updown)// 判 断 触 摸 笔 是 否 按 下 
{ 
downflag=1; 
touch timer fire(0); 
j 
if(ts-^s3c adc con==ADC TYPE 2){ 
. raw writel(0x0, ts base+S3C ADCCLRWK); 
. raw writel(0x0, ts base-S3C ADCCLRINT); 
j 
return IRO HANDLED; 
j 
static irqreturn t stylus action(int irqno, void *param) 
{ 
unsigned long data0; 
unsigned long datal; 
data0 = readl(ts base-* S3C ADCDATO); 
datal = readl(ts base* S3C ADCDAT!1); 
IESU ESTE 
if(ts-^resol bit==12) { 
#if defined(CONFIG TOUCHSCREEN NEW) 
ts->yp += S3C ADCDATO XPDATA MASK 12BIT- 
(data0 & S3C ADCDATO XPDATA MASK 12BIT); 
ts->xp += S3C ADCDATI YPDATA MASK 12BIT- 
(datal & S3C ADCDATI YPDATA MASK 12BIT); 


#else 
ts->xp += data0 & S3C ADCDATO XPDATA MASK 12BIT; 
ts->yp += datal & S3C_ADCDAT1_YPDATA MASK 12BIT; 
#endif 
j 
else { 
#if defined(CONFIG TOUCHSCREEN NEW) 
ts->yp += S3C ADCDATO XPDATA MASK - (data0 & S3C ADCDATO XPDATA MASK); 
ts->xp += S3C ADCDATI YPDATA MASK - (data1 & S3C ADCDAT1 YPDATA MASK); 


#else 
ts->xp += data0 & S3C ADCDATO XPDATA MASK; 
ts->yp += datal & S3C_ADCDAT1_YPDATA MASK; 


#endif 

} 

ts->count++; 

if (ts->count < (1<<ts->shift)) { 
/启动 坐标 转换 
writellS3C ADCTSC PULL UP DISABLE | AUTOPST, ts base*S3C ADCTSC); 
writel(readl(ts base--S3C ADCCON)| S3C ADCCON ENABLE START, 

ts base-S3C ADCCON); 


yelse 1 
mod timer(&touch timer, jiffies-1); 
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writel(WAITAINT(1), ts base+S3C ADCTSC); 
} 
if(ts-^s3c adc con--ADC TYPE 2) { 
. raw writel(0x0, ts base-S3C ADCCLRWK); 
. raw writel(0x0, ts base-S3C ADCCLRINT); 


j 
return IRO HANDLED; 


} 
touch timer fire 图 数 代码 如 下 : 


static vold touch timer fire(unsigned long data) 
1 
unsigned long data0; 
unsigned long datal; 
int updown; 
data0 = readl(ts base+S3C ADCDATO); 
datal = readl(ts base-S3C ADCDAT!1); 
updown = (!(data0 & S3C ADCDATO UPDOWN)) && (!(datal & S3C ADCDATI UPDOWN)); 
if (updown) {// 按 下 
if (ts->count) { 
if(downflag==0) 


{ 
input report abs(ts->dev, ABS X, ts->xp);//X 坐标 
input report abs(ts-»dev, ABS Y, ts->yp);//Y 坐标 
input report key(ts-^dev, BTN TOUCH, 1);// 触 摸 开始 
input report abs(ts-^dev, ABS PRESSURE, 1); 
input_sync(ts->dev);// 同 步 提交 输入 事件 
} 
else 
{ 
downflag=0; 
} 
} 
ts->xp = 0; 
ts->yp = 0; 


ts->count = 0; 
writel(S3C ADCTSC PULL UP DISABLE | AUTOPST, ts_base+S3C ADCTSC); 
writel(readl(ts base+S3C ADCCON)| S3C ADCCON ENABLE START, 

ts base-S3C ADCCON); 


else { 
ts->count = 0; 
input report key(ts-^dev, BTN TOUCH, 0);// 触 摸 结束 
input report abs(ts-^dev, ABS PRESSURE, 0); 
input sync(ts-^dev); 
writel(WAITAINT(0), ts base S3C ADCTSC); 
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} 
应 用 层 测 试 程序 如 下 : 


static int eventO fd = -1; 
struct input event evO[64]; 
static int handle eventO() 


1 
int button = 0, realx = 0, realy = 0, 1, rd; 
rd = read(eventO fd, ev0, sizeof(struct input event) * 64); 
If ( rd < sizeof(struct input event) ) return 0; 
for (i = 0; i < rd / sizeof(struct input. event); i++) 
1 
if(EV ABS--evO[i].type) 
1 
if(evO[1].code——0) 
1 
realx- evO[i].value; 
} 
if(evO[i].code==1) 
{ 
realy= evO[i].value; 
} 
} 
printf("event(%d): type: %d; code: %3d; value: %3d; realx: %3d; realy: %3d\n", 1, 
evO[1].type, ev0[il.code, evO[i].value, realx, realy); 
} 
return 1; 
} 


int main(void) 

{ 
int done 7 1; 
event0 fd = open("/dev/input/event0", O_RDWR); 
if(eventO fd <0 ) 


{ 
printf("open input device error\n"); 
return -1; 

j 

while ( done ) 

1 
printf("begin handel eventO... Wn"); 
done = handle event0(); 
printf("end handel eventO...3n"); 

j 


if (eventO fd>0) 
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{ 
close(eventO fd); 
event0 fd— -1; 

j 

return 0; 


j 
点 击 触摸 屏 ， 运 行 结果 如 下 : 


[root@urbetter /homel# ./demotest 

begin handel event0... 

event(0): type: 3; code: 0; value: 4514; realx: 4514; realy: 0 
event(1) type: 3; code: — 1; value: 10309; realx: 4514; realy: 10309 
event(2): type: 1; code: 330; value: — 1;realx: 4514; realy: 10309 
event(3): type: 3; code: 24; value: 1; realx: 4514; realy: 10309 
event(4): type: 0; code: 0; value: — 0; realx: 4514; realy: 10309 
end handel event0... 

begin handel event0... 

event(0): type: 3; code: 0; value: 4500; realx: 4500; realy: 0 
event(1): type: 3; code: — 1; value: 10295; realx: 4500; realy: 10295 
event(2): type: 0; code: — 0; value: — 0; realx: 4500; realy: 10295 
end handel event0... 


上 面 code=0 表示 义 轴 。code=1 表示 立轴 。 


10.7 Linux 红外 遥控 驱动 


核 


备 ， 


Y 


peny 


主要 代码 如 下 : 


intre register device(struct rc dev *dev) 
1 
static bool raw init = false; /* 原始 信号 解码 器 是 否 加 载 */ 
struct rc map *rc map; 
const char *path; 
int attr = 0; 
int minor; 
int rc; 
if (!dev || ldev->map name) 
return -EINVAL; 
rc map —rc map get(dev-map name);/ 获 取 映 射 表 
if(!rc map) 
rc map - rc map get(RC MAP EMPTY); 
if (lre map || 'rc map-»scan || re map-»size == 0) 
return -EINVAL; 


输入 子 系统 


红外 遥控 广泛 用 于 电器 与 仪器 的 近 距 离 无 线 控制 ， 一 般 传输 距离 在 10m 以 内 。Linux 内 
的 红外 接收 (IR) 使 用 的 也 是 输入 子 系 统 。trc register device 函数 用 来 注册 一 个 肥 控 设 
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set bit(EV. KEY, dev->input dev->evbit); 
set bit(EV. REP, dev->input dev->evbit); 
set bit(EV MSC, dev->input dev--^evbit); 
set bit(MSC SCAN, dev->input dev-mscbit); 
if (dev-^open) 
dev->input dev->open — ir open; 
if (dev-^close) 
dev->input dev-»close = ir close; 
minor = ida simple get(&rc ida, 0, RC DEV MAX, GFP KERNEL); 
if (minor < 0) 
return minor; 
dev->minor = minor; 
dev set name(&dev-^dev, "rc?ou", dev->minor); 
dev set drvdata(&dev-»dev, dev); 


mutex lock(&dev--lock); 
rc = device add(&dev-^dev); 
if (rc) 
goto out unlock; 
Ic — ir setkeytable(dev, rc map); 
if (rc) 
goto out. dev; 
dev-^input dev--dev.parent = &dev-»dev; 
memoepy(&dev--input dev->id, &dev--input id, sizeof(dev-—input id)); 
dev->input dev->phys = dev->input phys; 
dev->input dev->name = dev->input name; 
mutex unlock(&dev->lock); 
rc = input register_device(dev->input_dev);/ 注 册 输入 设备 
mutex lock(&dev->lock); 
if (rc) 
goto out table; 
/红外 重复 事件 参数 
dev->input dev->rep[REP DELAY] = 500; 
dev->input dev->rep[REP PERIOD] = 125; 


mutex unlock(&dev--lock); 
return 0; 


} 
内 核 中 的 gpio-ir-recv 模块 是 使 用 GPIO 口 接收 红外 遥控 信号 的 通用 驱动 : 


static int gpio ir recv_probe(struct platform device *pdev) 
1 
struct gpio rc dev *gpio dev; 
struct rc dev *rcdev; 
const struct gpio ir recv platform data *pdata —pdev-^dev.platform data; 


int rc; 
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让 (pdev->dev.of node) {// 从 设备 树 读 信息 
struct gpio ir recv platform data *dtpdata = 
devm kzalloc(&pdev-^dev, sizeof(*dtpdata), GFP KERNEL); 
if (!dtpdata) 
return -ENOMEM; 
IC = gpio ir recv get devtree pdata(&pdev-»dev, dtpdata); 
if (rc) 


return rc; 

pdata — dtpdata; 
} 
if (!pdata)return -EINVAL; 
if (pdata-^gpio nr < 0) 

return -EINVAL; 
gpio dev = kzalloc(sizeof(struct gpio rc dev), GFP KERNEL); 
if(!gpio dev) 

return -ENOMEM; 
rcdev ^ rc allocate device(); 
if (!rcdev) 1 

rc — -ENOMEM; 

goto err allocate device; 
} 
rcdev->priv = gpio dev; 
rcdev->driver type = RC DRIVER IR RAW; 
rcdev-2input name = GPIO IR. DEVICE NAME; 
rcdev-2input phys = GPIO IR DEVICE NAME "/inputO"; 
rcdev->input id.bustype - BUS HOST; 
rcdev--input id.vendor = 0x0001 ; 
rcdev-^input id.product = 0x0001; 
rcdev--input id.version = 0x0100; 
rcdev-»dev.parent = &pdev-^dev; 
rcdev-^driver name = GPIO IR DRIVER NAME; 
rcdev-^min timeout = 0; 
rcdev--timeout = IR DEFAULT TIMEOUT; 
rcdev-max timeout = 10 * IR DEFAULT TIMEOUT; 
if (pdata-^allowed protos) 

rcdev-^allowed protocols = pdata-^allowed protos; 
else 

rcdev-^-allowed protocols = RC BIT ALL; 
rcdev-map name = pdata-^map name ?: RC MAP EMPTY,; 
gpio dev--rcdev = rcdev; 
gpio dev-^gpio nr= pdata-^gpio nr; 
gpio dev-^active low = pdata-^»active low; 
setup timer(&gpio dev->flush timer, flush timer, (unsigned long)gpio dev); 
Ic = gpio request(pdata-^gpio nr, "epio-ir-recv"); 
if (rc « 0) 

goto err gpio request; 
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IC -—gpio direction input(pdata-^gpio nr); 
if (rc « 0) 
gotoerr gpio direction input; 
rc = rc register device(rcdev);// 注 册 遥 控 设 备 
if (rc < 0) { 
dev err(&pdev-»dev, "failed to register rc device"); 
goto err register rc device; 
j 
platform set drvdata(pdev, gpio dev); 
rc request any context irq(gpio to irq(pdata-^gpio nr),gpio ir recv irq, 
IRQF TRIGGER FALLING|IRQF TRIGGER RISING, 
"gpio-ir-recv-irq", gpio_dev);/ 申 请 中 断 


if (rc « 0) 
goto err request irq; 
return 0; 


} 
request_any_context_irq 函数 也 是 一 个 中 断 申请 函数 ， 它 会 根据 上 下 文 自动 选择 中 断 处 


时 方式 (硬件 中 断 或 者 线程 处 理 )。GPIO 红外 接收 设备 的 平台 数据 结构 如 下 : 
Struct gpio ir recv platform data { 
int gpio nr;//GPIO 端口 号 
bool active low; 
u64 allowed_protos;/ 文 持 的 遥控 协议 


const char ^ *map name; 
h 
例如 S3C6410X 的 平台 设备 设置 如 下 : 


static struct gpio ir recv platform data s3c6410 gpio ir info = ( 
.gpio nr = S3C2410 GPE(0), 
„active low = 1, 


h 

static struct platform device s3c6410 gpio ir- ( 
.name = "gpio-rc-recv", 
id =-], 
.dev ={ 


.platform data = & s3c6410 gpio ir info, 
us 
h 
没有 设置 allowed_protos 就 意味 着 文 持 所 有 的 红外 编码 。 常 用 的 红外 并 控 协 议 包 括 NEC 
与 RC5、RC6 编码 。 对 这 些 编码 进行 解码 的 算法 称 为 解码 器 (decoder )。 内 核 使 用 
ir raw handler 结构 表示 不 同 的 解码 器 : 


struct ir raw handler ( 
struct list head list; 
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u64 protocols; /* HNA! */ 

int (*decode)(struct rc. dev *dev, struct ir raw event event); 
/* 仅 用 于 lire decoder */ 

int (*raw register)(struct rc dev *dev); 

int (*raw unregister)(struct rc dev *dev); 


js 
例如 RC5 编码 的 注册 过 程 如 下 : 


static struct ir_ raw handlerrc5 handler = { 
protocols — — RC BIT RCS|RC BIT RC5X|RC BIT RC5 SZ, 


.decode —ir rc5 decode, 
h 
static int  initir rc5 decode init(void) 
1 
ir raw handler register(&rc5 handler); 
printk(KERN INFO "IR RC5(x/sz) protocol handler initializedn"); 
return 0; 
j 


ir rc5 decode 函数 实现 RCS 解码 算法 。 
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块 设备 驱动 程序 是 Linux 内 核 中 的 


A — 


uu 


大 类 驱动 程序 。 块 设备 和 


Jtt pu] 53 R 


D AA 


学 符 设备 最 大 的 区 别 在 


于 读 写 数据 的 基本 单元 不 同 。 块 设备 与 文件 系统 有 者 


程序 开发 以 及 文件 系统 的 基础 知识 。 


11.1. 块 设备 驱动 原理 


[DEZ 


BESIDE oS IB]. Beute S MU IU EAS PC ES. BU 


干 丝 万 缕 的 联系 。 本 章 介绍 块 设备 驱动 


轧 义 ， 块 设备 就 是 以 块 的 方式 进行 读 写 的 设备 。 块 设备 和 字符 设备 最 大 的 区 别 在 于 


而 字符 设备 的 基本 单元 为 字 节 。 块 设备 文 持 随机 访问 ， 字 符 设备 


来 看 ， 字 符 设 备 的 实现 比较 简单 ， 内 核 例 程 和 用 户 态 
备 的 file operations 维护 。 通 常 块 设备 上 


杂 ， 读 写 API 没有 
^ud 


请 求 。 
11.1.1 block device 


block device 结构 代表 了 内 核 ! 
一 人 分 


分 区 。 当 这 个 结构 代表 
bd part 成 员 指 向 设备 的 分 


接 到 块 设备 层 ， 而 是 


E 


通常 为 一 个 sector， 
顺序 访问 。 从 实现 角度 


I ES 


字符 设 


上 磁盘 


只 能 


API 一 一 对 应 ， 这 种 映射 关系 由 


的 数据 以 文件 的 形式 存放 。 块 设备 接口 则 相对 复 


的 一 个 块 设备 。 
十， 它 的 


[X Hi 


接 到 文件 系统 层 ， 然 


bd contains 成 员 指 向 包含 这 个 分 


后 再 由 文件 系统 层 发 起 读 写 


它 可 以 表示 整个 磁盘 或 磁盘 的 一 个 特定 


区 的 设备 ， 


区 结构 。 当 这 个 结构 代表 


gendisk 结构 。 


struct block device { 
dev t 
int 
struct inode * 


struct super block * 


Struct mutex 
struct list head 
void * 

void * 

int 

bool 


bd dev; /# 搜 索 键 %/ 
bd openers; 

bd inode; 

bd_super;// 超 级 块 


个 块 设备 时 ，bd_disk 成 员 指 向 设备 的 


bd mutex; /* 打 开 / 关 闭 互 斥 锁 */ 


bd inodes; 

bd claiming; 

bd holder; 

bd holders; 

bd write holder; 


#ifdef CONFIG SYSFS 


struct list head 
#endif 


bd holder disks; 


struct block device * bd contains; 


unsigned 


xi 
n» 


bd block size; /分 区 包 人 名 


的 块 数 


二 :并 
FR 
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structhd struct * ^ bd _part/ 分 区 信息 
unsigned bd part count;// 设 备 中 打开 的 分 区 数 
int bd invalidated; 

structgendisk * ^ bd _disk;// 通 用 分 区 结构 

struct request queue * bd queue;// 请 求 队列 


struct list head bd list; 

unsigned long bd private; 

int bd fsfreeze_count;// 冻 结 进程 数 
struct mutex bd fsfreeze mutex; 


ls 
向 内 核 注 册 和 注销 一 个 块 设备 可 使 用 如 下 函数 : 


int register blkdev(unsigned int major, const char *name); 


int unregister blkdev(unsigned int major, const char *name); 
register blkdev 函数 向 内 核 申 请 注册 以 major 为 主 设备 号 的 块 设备 。 假 如 major 为 0， 则 
交 给 内 核 自 动 分 配 一 个 主 设备 号 。 假 如 主 设备 号 major 已 经 被 占用 ， 则 返回 失败 。 
register blkdev 成 功 返 回 之 后 ， 就 可 以 使 用 该 主 设备 号 。 


LH 


H 


11.1.2 gendisk 


gendisk 结构 表示 一 个 通用 的 分 区 。 


struct gendisk { 
//major, first minor 与 minors 为 输入 参数 ， 勿 直接 使 用 ， 应 使 用 disk devt() ^ disk max parts(0) 访 问 
int major; JERR 
int first minor;/ 第 一 个 次 设备 号 
int minors; /次 设备 号 最 大 数量 ， 代 表 可 分 区 数量 
char disk name[DISK NAME LEN]; [* EIR */ 
char *(*devnode)(struct gendisk *gd, umode_t *mode); 
unsigned int events;// 支 持 的 事件 
unsigned intasync events; ”/* 异 步 事件 */ 
struct disk part tbl — rcu *part tbl; 
struct hd struct part0; 
const struct block device operations *fops;// 块 设备 操作 接口 
struct request queue *queue;// 请 求 队列 
void *private data; 


int flags; 
struct device *driverfs dev; 
struct kobject *slave dir; 
struct timer rand state *random; 
atomic tsync io; — /* 用 于 RAID*/ 
struct disk events *ev; 
#ifdef CONFIG BLK DEV INTEGRITY 
struct kobject integrity kobj; 
#endif /*CONFIG BLK DEV INTEGRITY*/ 
int node id; 
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struct badblocks *bb; 
js 


gendisk 结构 的 操作 函数 包括 以 下 几 个 ; 


void add disk(struct gendisk *disk); 

void del gendisk(struct gendisk *gp); 

struct gendisk *get gendisk(dev t dev, int *partno); 

struct block device *bdget disk(struct gendisk *disk, int partno); 

struct hd. struct *add partition(struct gendisk *disk, int partno,sector t start, sector t len, int flags, 
struct partition meta info *info);// 添 加 分 区 


yt pg E 


void set capacity(struct gendisk *disk, sector t size);// V EŒ 


三 | 


sector t get capacity(struct gendisk *disk);// 获 取 容 量 


block device operations 结构 是 块 设备 对 应 的 操作 接口 。 


struct block device operations { 
int (*open) (struct block device *, fmode t); 
void (*release) (struct gendisk *, fmode t); 
int (*rw page)(struct block device *, sector t, struct page *, int rw); 
int (*ioctl) (struct block device *, fmode t, unsigned, unsigned long); 
int (*compat ioctl) (struct block device *, fmode t, unsigned, unsigned long); 
long (*direct access)(struct block device *, sector t, void  pmem **,pfn t *); 
unsigned int (*check events) (struct gendisk *disk,unsigned int clearing); 
int (*media changed) (struct gendisk *);// 过 时 接口 ， 用 check events 替代 
void (*unlock native capacity) (struct gendisk *); 
int (*revalidate disk) (struct gendisk %);/ 激 活 磁盘 
int (*getgeo)(struct block device *, struct hd geometry *); 


/*this callback is with swap lock and sometimes page table lock held*/ 
void (*swap slot free notify) (struct block device *, unsigned long); 
struct module *owner; 

const struct pr ops *pr ops; 


5 


11.1.3 bio 


bio 结构 用 来 描述 块 设备 IO 单元 ， 它 记录 了 VO 请 求 的 内 存 、 磁 盘 扇 区 、 方 向 等 信息 。 
bio 涉及 的 内 存在 bio. vec 结构 中 描述 。 一 个 bio 包含 1 个 或 多 个 bio_vec。 


struct bio { 
struct bio *bi next; VK BA FI 
struct block device  *bi bdev;/ 发 起 请 求 的 块 设备 
unsigned int bi flags; PERS. e EI 
int bi error; 
unsigned long bi_rw;// 读 写 标志 
struct bvec iter bi iter; 
unsigned int bi phys segments; 
unsigned int bi seg front size; 
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unsigned int bi seg back size; 

atomic t . bi remaining; 

bio end io t *bi end io; 

void *bi private; 

unsigned short bi vent; /*bio vec 数量 */ 

unsigned short bi max vecs; 人 * 最 大 的 bio_vec 数量 */ 

atomic t . bi cent; /*pin count*/ 

struct bio vec *bi io vec; /*bio vec 链表 ， 包 含 当 前 VO 涉及 的 内 存 信 息 */ 
struct bio set *bi pool; 

struct bio vec bi inline vecs[0]; 


js 


11.1.4 请求 队列 


块 设备 UO 单元 (bio) 会 被 提交 给 请 求 队列 。request_queue 结构 描述 块 设备 的 请 求 队 
列 ， 该 结构 定义 如 下 : 


struct request queue ( 


struct list head queue head; 
struct request *last merge; 
struct elevator queue *elevator; 

int nr rqs[2]; 

int nr rqs elvpriv; 


struct request list root rl; 


request fn proc *request fn; 

make request fn — *make request fn;// 发 起 LO 请 求 
prep rq fn *prep rq fn; 

unprep rq fn *unprep rq fn; 

softirq done fn *softrq done fn; 

rq timed out fn *rq timed out fn; 

dma drain needed fn *dma drain needed; 

lld busy fn *]ld busy fn; 


struct blk mq ops — *mq ops; 
unsigned int *mq map; 


struct blk mq ctx  percpu *queue ctx; 


unsigned int nr queues; 

struct blk mq hw ctx **queue hw ctx; 
unsigned int nr hw queues; 

sector t end sector; 

struct request *boundary rq; 


struct backing dev info ^ backing dev_ info;/ 后 备 存储 设备 


js 


generic make request 函数 将 bio 提交 给 请 求 队列 : 


blk qc t generic make request(struct bio *bio) 
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struct bio list bio list on stack; 

blk qc tret- BLK QC T NONE; 

if(!generic make request checks(bio)) 
goto out; 

if (current-^bio list) { 
bio list add(current-^bio list, bio); 
goto out; 

j 

BUG ON(bio-^bi next); 

bio list init(&bio list on stack); 

current-^bio list = &bio list on stack; 

do 1 


struct request queue *q = bdev get queue(bio-^bi bdev);// 获 取 请 求 队列 
if (likely(blk queue enter(q, false) == 0)) {// 开 始 处 理 bio 
ret = q-^make request fn(q, bio); 


blk queue exit(q); 
bio = bio list pop(current-^bio list);// 下 一 个 bio 
} else ( 
struct bio *bio next-— bio list pop(current-»bio list); /下 一 个 bio 
bio io_error(bio);// 标 记 错 误 
bio = bio next; 
} 
} while (bio); 
current->bio list = NULL; 
out: 


return ret; 


} 
内 核 默认 的 make request fn 函数 为 : 


blk qc tblk queue bio(struct request queue *q, struct bio *bio); 


blk queue bio 会 进行 VO 合成 操作 ， 并 创建 request， 提 交 给 IO 调度 进行 处 理 。 
对 于 不 需要 使 用 IO 调度 器 的 设备 ， 可 以 奉 换 make request fn 函数 ， 绕 过 调度 : 


struct request queue *blk alloc queue(gfp t gfp mask); 
void blk queue make request(struct request queue *q, make request fn *mfn); //4E X. make - 
//request fn 函数 


f) rri 简单 块 设备 驱动 程序 实例 
本 例 演示 一 个 不 采用 VO 调度 器 的 块 设备 驱动 。 代 人 码 见 \samples\11lblock\11-1lblock。 核 
心 代码 如 下 : 


struct simdisk { 
spinlock t lock; 
struct request queue *queue; 
struct gendisk *gd; 
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struct proc dir entry *procfile; 

int users; 

unsigned long size; 

char *diskdata; 
h 
static int errno; 
static int simdisk count — 1; 
module param(simdisk count, int, S IRUGO); 
MODULE PARM DESC(simdisk count, "Number of simdisk units."); 
static int n files; 
static int simdisk major - SIMDISK MAJOR; 
/使 用 内 存 模拟 一 个 存储 设备 


static void simdisk transfer(struct simdisk *dev, unsigned long sector, 


unsigned long nsect, char *buffer, int write) 


1 
loff t offset = sector «« SECTOR. SHIFT; 
unsigned long nbytes = nsect << SECTOR. SHIFT; 
If (offset > dev->size || dev->size - offset < nbytes) { 
pr notice("Beyond-end 96s (%ld %ld)\n",write ? "write" : "read", offset, nbytes); 
return; 
} 
spin lock(&dev->lock); 
while (nbytes > 0) { 
Ssize t io=nbytes; 
if (write) 
memcpy(dev->diskdata + offset, buffer, nbytes); 
else 
memcpy(buffer, dev->diskdata + offset, nbytes); 
if (io == -1) { 
pr_err("SIMDISK: IO error %d\n", errno); 
break; 
} 
buffer += io; 
offset += io; 
nbytes -= io; 
} 
spin unlock(&dev->lock); 
} 


static blk qc t simdisk make request(struct request queue *q, struct bio *bio) 


1 


struct simdisk *dev = q-^queuedata; 
struct bio vec bvec; 
struct bvec iter iter; 
sector t sector = bio->bi iter.bi sector; 
bio for each segment(bvec, bio, iter) {// 遍 历 bio 中 的 段 
char *buffer— — bio kmap atomic(bio, iter);// 获 取 绥 冲 地 址 
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unsigned len = bvec.bv len >> SECTOR. SHIFT; 
simdisk transfer(dev, sector, len, buffer, 
bio data dir(bio) — WRITE); 
sector += len; 
. bio kunmap atomic(buffer); 
j 
bio endio(bio); 
return BLK QC T NONE; 


j 
static int simdisk open(struct block device *bdev, fmode t mode) 
{ 
struct simdisk *dev = bdev->bd disk->private_data; 
spin lock(&dev->lock); 
if (!dev->users) 
check disk change(bdev); 
T-tdev--users; 
spin unlock(&dev--lock); 
return 0; 
j 
static void simdisk release(struct gendisk *disk, fmode t mode) 
1 
struct simdisk *dev = disk-^private data; 
spin lock(&dev--lock); 
--dev--users; 
spin unlock(&dev--lock); 
} 
// 块 设备 操作 接口 
static const struct block device operations simdisk ops = { 
.owner = THIS MODULE, 
.open — simdisk open, 
release — simdisk release, 
h 


static struct simdisk *sddev; 
static struct proc dir entry *simdisk procdir; 
static int — init simdisk setup(struct simdisk *dev, int which,struct proc dir entry *procdir) 
{ 
spin lock init(&dev->lock); 
dev--users = 0; 
dev-»size = nsectors*hardsect size; 
dev-»diskdata = vmalloc(dev-^size); 
if (dev->diskdata == NULL) 
return -ENOMEM; 
/分 配 队列 
dev->queue = blk alloc queue(GFP KERNEL); 
if (dev->queue — NULL) { 
pr err("blk alloc queue failedn"); 
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goto out alloc queue; 
} 
blk queue make request(dev->queue, simdisk_make_request);// 设 置 IO 请 求 处 理 函 数 
dev->queue->queuedata = dev; 
dev->gd=alloc disk(SIMDISK MINORS); 
if (dev->gd == NULL) { 
pr ermr("alloc disk failed"); 
goto out alloc disk; 


} 

dev->gd->major = simdisk_major;// 主 设备 号 
dev->gd->first minor = which; 

dev->gd->fops = &simdisk ops; 

dev->gd->queue = dev->queue; 

dev->gd->private_data = dev; 

snprintf(dev-^gd-^disk name, 32, "simdisk%d", which); 

set capacity(dev-»gd, dev->size >> SECTOR. SHIFT);// x EMRA 
add disk(dev->gd);/ 添 加 一 个 分 区 

return 0; 


地 


out alloc disk: 


blk cleanup queue(dev-»queue); 
dev->queue = NULL; 


out alloc queue: 


j 


return -EIO; 


static int — init simdisk init(void) 


1 


int i; 

/注册 块 设备 

if (register blkdev(simdisk major, "simdisk") < 0) 1 
pr err" SIMDISK: register blkdev: od", simdisk major); 
return -EIO; 


j 
pr info("SIMDISK: major: %d\n", simdisk major); 
if(n files > simdisk count) 
simdisk count- n files; 
if (simdisk count > MAX SIMDISK COUNT) 
simdisk count = MAX SIMDISK COUNT; 
sddev = kmalloc(simdisk count * sizeof(struct simdisk), GFPP. KERNEL); 
if (sddev == NULL) 
goto out unregister; 
ETIK 
for (i = 0; i < simdisk count; ++i) { 
if(simdisk setup(sddev + 1, i, simdisk procdir) != 0) 
1 


printk("simdisk setup error n"); 


j 


return 0; 
kfree(sddev); 
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out unregister: 
unregister blkdev(simdisk major, "simdisk"); 
return -ENOMEM; 

} 


module init(simdisk init); 


本 例 运 行 结果 如 下 : 


11.2 


[root(Q)urbetter drivers | insmod simdisk.ko 
SIMDISK: major: 240 

[root(a)urbetter drivers] mkfs.ext2 /dev/simdiskO 
Filesystem label= 

OS type: Linux 

Block size=1024 (log=0) 

Fragment size=1024 (log=0) 

1280 inodes, 5120 blocks 

256 blocks (5%) reserved for the super user 

First data block=1 

Maximum filesystem blocks=262144 

1 block groups 

8192 blocks per group, 8192 fragments per group 
1280 inodes per group 

[root@urbetter drivers |? mount -t ext2 /dev/simdisk0 /mnt/disk 
[root@urbetter drivers]# df 


Filesystem 1K-blocks Used Available Use% Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 29799484 109469048 17315768 39% / 

tmpfs 61796 0 61796 096 /dev/shm 
/dev/simdiskO 4955 13 4686 0% /mnt/disk 


[root@urbetter drivers]# cd /mnt/disk 
[root@urbetter disk]# ls 

lost+found 

[root@urbetter disk]? echo fgj > a 
[root@urbetter disk] df 


Filesystem 1K-blocks Used Available Use% Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 29799484 . 10946948 . 17315768 3996 / 

tmpfs 61796 0 61796 096 /dev/shm 
/dev/simdiskO 4955 14 4685 096 /mnt/disk 
[root(Q)urbetter disk]? ls 

a lost-found 

[root(Qyurbetter disk]? cat a 

fgj 


Linux 文件 系统 概述 


块 设备 上 通常 会 建立 多 个 分 区 ， 每 个 分 区 被 格式 化 成 一 种 文件 系统 ， 方 便 用 户 访问 与 操 


作 。 文 伯 


系统 是 指 存储 设备 上 的 分 区 和 目录 结构 。 一 个 存储 设备 可 以 包含 一 个 或 多 个 文件 系 


Zt. Linux 文件 系统 将 用 户 接 口 层 、 文 件 系统 实现 和 操作 存储 设备 的 驱动 程序 分 隔 开 。 
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Linux 下 的 文件 系统 主要 可 分 为 三 大 块 : (1) 提供 给 应 用 层 的 系统 调用 ; 2) 虚拟 文件 系统 
VFS(Virtual File System); (3) 挂 载 到 VFS 中 的 各 种 实际 文件 系统 ， 如 ext3. ext4, jffs2. 
ubifs 等 。 
11.2.1 虚拟 文件 系统 

在 Linux. 下 几乎 所 有 的 东西 都 被 当 作文 件 看 待 ， 如 普通 的 文件 、 目 录 、 字 符 设 备 、 块 设 
备 、 套 接 字 等 ， 不 同 的 文件 系统 使 用 同一 套 系统 调用 。 虚 拟 文件 系统 正 是 实现 这 两 点 特性 的 


关键 。 虚 拟 文件 系统 只 存在 内 存 中 ， 系 统 启动 时 创建 。 
虚拟 文件 系统 使 用 超级 数据 块 来 管理 挂 装 的 文件 系统 : 


Tr 


HU 


Im 


struct super block { 
struct list head s_list;/* 固 定 为 第 一 个 成 员 */ 


dev t s dev; I$ 2x RA 

unsigned char S blocksize bits; 

unsigned long s_blocksize;// 块 大 小 

loff t s_maxbytes; /最 大 文件 大 小 */ 
struct file system type *s_type;// 文 件 系 统 类 型 
const struct super operations *s_op;// 操 作 结 构 
const struct dquot operations *dq op; 

const struct quotactl ops *s qcop; 

const struct export operations *s export op; 

unsigned long s flags; 

unsigned long s iflags; [*W SB I * 标 记 */ 
unsigned long s_magic; 

struct dentry *s root; 

struct rw semaphore s umount; 

int S count; 

atomic t S active; 


const struct xattr handler **s xattr; 

struct hlist bl head s anon; 

struct list head s mounts; 

struct block device *s_bdev;// 关 联 的 块 设备 

struct backing dev info *s_bdi; /关联 的 后 备 存储 设备 
struct mtd info *s_mtd;// 关 联 的 MTD 设备 


js 


file system type 结构 用 于 描述 具体 的 文件 系统 的 类 型 信息 。Linux 支持 的 每 种 文件 系统 
都 对 应 一 个 fle_system_ type 结构 。 


struct file system type { 
const char *name; 
int fs flags; 
struct dentry *(*mount) (struct file system type *, int,const char *, void *); 
void (*kill sb) (struct super block *); 


struct module *owner; 
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struct flle system type * next; 

struct hlist head fs supers; 

struct lock class key s lock key; 
struct lock class key s umount key; 


struct lock class key s vfs rename key; 
struct lock class key s writers key[SB FREEZE LEVELS]; 


h 
XC TF Z& Bt Hk DECRE SICUL OC IR ZEB ARS B3 Pa 256 P xC TE ZR BEAR EE CIT, 
file system type 结构 的 mount 成 员 函 数 将 被 调用 。 


struct dentry *mount fs(struct file system type "type, int flags, const char *name, void *data) 


1 


root = type-^mount(type, flags, name, data); 


} 
下 面 是 ubifs 文件 系统 的 注册 代码 : 


static struct file system type ubifs fs type={ 


.name = "ubifs", 
.Owner  — THIS MODULE, 
.mount = ubifs mount, 


.kill sb = kill ubifs super, 


je 
static int — init ubifs init(void) 
{ 
err = register filesystem(&ubifs fs type); 
if (err) 1 
pr. err("UBIFS error (pid 96d): cannot register file system, error od", 
current-^pid, err); 
goto out dbg; 
j 
j 


的 文件 操作 接口 与 节点 操作 接口 。 


文件 系统 中 的 节点 用 inode 表示 ， 每 个 inode 有 
每 种 文件 系统 都 要 提供 自己 的 节点 操作 函数 : 


struct inode ( 
const struct inode operations *1 op; 


const struct file operations *i fop; 
5 
11.2.2 ”日志 文件 系统 和 非 日 志文 件 系 统 


文件 系统 包括 两 大 类 : 日 志文 件 系统 和 非 日 志文 件 系 统 。Linux 系统 中 可 以 混合 使 用 日 
志文 件 系 统 和 非 日 志文 件 系统 。 
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本 


d 


U 


非 日 志文 件 系统 在 工作 时 ， 不 对 文件 系统 的 更 改进 行 日 
文件 块 的 方式 把 数据 存储 在 磁盘 


件 系统 的 工作 就 是 维 


出 文件 内 容 。 
区 使 用 信息 。 


3x 


H 


E 人 磁盘 


y 
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上 。 每 个 文件 在 磁盘 上 


Z 


都 


上 的 存放 ， 记 录 文 件 占 


情况 也 要 记录 在 磁盘 上 。 文 件 系 统 帮 


E 读 写 文件 时 ， 首 先 找 


了 的 扇 区 信息 
文件 使 朋 


/中 


到 


件 系 统 首 先 找 ip 


如 果 要 写 文 从 
Linux 支持 的 非 日 


F, X 


(Windows NT), Sun 的 UFS 等 。 


件 的 磁 
SNET 
志文 件 系 统 则 是 
设计 思想 是 


中 存 有 


BAF H 


志文 件 系统 能 


Ti) X d 


FH 


电 ， 结 果 就 会 造成 文人 


信 息 写 入 到 磁盘 


的 内 


够 工作 得 很 稳定 ， 


到 可 上 月 
志文 件 系统 包括 


区 ， 进 行 数据 奶 加 。 
Ext2, FAT, VFAT, HPFS (OS/2), NTFS 


HEETE 


分 区 中 ， 


另外 扇 


na 


有 的 扇 区 号 ， 然 后 


肩 区 


区 


区 , 
的 使 


不 少 问题 。 例 如 ， 如 果 系 统 刚 


刚 将 


还 没有 来 得 及 将 文件 内 容 写 入 磁盘 ， 


A 


容 仍 然 是 老 内 容 ， 而 分 


从 中 i 
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志 记 录 。 文 件 系 统 通 过 为 文件 分 
占用 一 个 以 上 的 磁盘 


X 
用 


读 


同时 更 新 文件 扇 


文 


这 时 系统 意 


f 


E 非 日 志文 件 系统 的 基础 


上 ， 加 入 了 文件 


区 信息 是 新 内 容 ， 二 者 不 一 致 了 。 


系统 更 改 的 日 志 


me 


AH 是 跟踪 


记录 文件 系统 的 变化 ， 并 将 变化 内 容 s 


SWK. Hw 


志文 件 


志 记 录 


H) 而 ， 
的 时 间 ， 但 


Wr 


, 


系统 习 


写 操作 首先 是 对 记录 文 伯 


进行 操 作 ， 若 整 


No H; 


志文 件 系统 刀 


写 操作 1 


E 启 时 ， 会 根据 


志 记 录 来 恢复 中 断 


是 伐 盘 文 伯 


的 安全 性 得 到 


Ext3/4, XFS, JFS, JFFS2/3. ubifs 等 。 
11.2.3 JE PESE 


Linux 内 核 局 动 完 成 以 后 ， 内 核 将 加 


载 


个 


民 文件 


于 某 种 原因 


ERAT 


分 
(如 系 


i A 


了 显著 提高 。Linux 系统 支持 的 日 志 


系统 ， 为 启动 init 进程 做 准备 。 如 


的 
区 
统 


志 增 加 了 文件 操作 
志文 件 系统 包 


15 


FH 
ZM 


Linux 启动 后 没有 在 指定 位 置 找 到 根 文 件 系 统 ， 则 系统 将 出 现 kernel panic 错误 。 

展 文件 系统 一 般 包含 基本 的 目录 、 程 序 运行 的 基本 库 、 基 本 的 工具 。 根 文件 系统 通常 比 
较 小 ， 因 为 它 包含 了 一 些 非常 关键 的 文件 ， 小 而 不 频繁 修改 的 文件 系统 不 容易 遭 到 破坏 。 崩 
省 的 根 文件 系统 意味 着 系统 无 法 启动 。Linux 文 持 多 种 根 文 件 系统 类 型 ， 在 嵌入 式 设备 中 常 
用 的 有 ROMFS、JFFS2、NFS、CRAMFS、YAFFS、ubifs 等 。 

民 文 件 系统 的 目录 结构 见 表 11-1. 

表 11-1 根 文件 系统 的 目录 结构 
E 说 明 
/bin Linux 普通 用 户 操作 命令 
/sbin 类 似 /bin， 一 般 不 针对 普通 用 户 ， 是 root 用 户 的 默认 路 径 
/etc 存放 配置 文件 
/root root 用 户 的 根 目录 
/lib 应 用 程序 依赖 的 共享 库 
/lib/modules 可 加 载 模 块 
/dev 设备 文件 
/tmp 临时 目录 ， 通 常 是 wartmp 的 软 链接 
/boot 引导 目录 
/mnt 文件 系统 加 载 点 
/proc /proc 文件 系统 ， 内 核 状 态 监控 与 控制 
/usr 户 应 用 程序 和 库 
/var 系统 运行 时 使 用 的 目录 ， 通 常 包含 系统 运行 日 志和 一 些 临时 文件 
/home 户 目录 
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11.2.4 文件 系统 总 结 
Linux 支持 多 种 文件 系统 ， 包 括 sysfs. proc 等 系统 文件 系统 ， 以 及 Cramfs, Ubifs, 


Ext2/3/4, NFS, Jffs 


第 2 版 


11-2 是 Linux 下 的 几 种 常见 的 文件 系统 。 
表 11-2 Linux 文件 系统 的 比较 


2 等 实体 文件 系统 ， 还 支持 Windows 的 FAT32. NTFS 等 文件 系统 。 表 


名 称 说 Bj 可 写 性 hk 缩 特 人 性 
TESE x Nm EINEN, GERE 
Cramfs F Flash 的 非 日 志文 件 系统 Hi 压缩 比 高 达 2:1 时 序 以 XIP 方式 运行 
从 ext23 文件 系统 发 展 而 来 的 日 志文 件 系 E 动 修复 ， 支 持 大 文件 ， 
Ext4 。 | 统 。 可 用 于 硬盘 等 大 容量 设备 ii 不 支持 压缩 过 无 限 子 目录 
于 Flash 上 的 Flash 日 志文 件 系统 ， 提 
供 垃圾 回收 机 制 ， 不 需要 马上 对 探 写 越界 的 EPH, BRKE, fe 
Jffs2 块 进行 擦 写 ， 只 需要 将 其 设置 一 个 标志 ， 标 可 写 支持 数据 压缩 i 闪存 的 和 用 率 bos 
明 为 脏 块 ， 当 可 用 的 块 数 不 足 时 ， 垃 圾 回收 dé 
机 制 才 开始 回收 这 些 节点 
NAND Flash 上 效果 很 理想 的 文件 系统 ， 
提供 了 损耗 平衡 和 掉 电 保护 ， 保 证 数据 在 系 c m 速度 快 ， 占 用 内 存 少 ， 只 
YAFFS2 | 统 对 文件 系统 修改 的 过 程 中 发 生意 外 而 不 被 | 03 不 支持 压缩 支持 NAND Flash 
破坏 
Pu 于 Flash 上 的 Flash 日 志文 件 系统 。 它 "m 支持 LZO 和 zlib | ”支持 write-back DATE fett: 
是 Jffs2 的 后 代 ， 它 将 索引 存储 在 Flash 上 Š 压缩 器 量 、 快 速 TO 
LO IRR. E: m 可 远程 访问 文件 ， 多 重 数 
NFS 基于 UDP 的 网 络 文件 系统 可 写 不 文 持 压缩 据 保护 ， 带 网 络 加 锁 管理 
11.2.5 ”文件 系统 挂 载 
fr Linux 中 将 一 个 文件 系统 与 一 个 存储 设备 关联 起 来 的 过 程 称 为 挂 载 (mount)。 使 用 


mount 命令 可 以 将 一 个 文件 系统 加 载 到 当前 文件 系统 层次 结构 
系统 和 一 个 挂 载 


件 系 


型 、 文 人 


录 。 


L 


。 在 执行 挂 载 时 ， 要 提供 文 


mount [-afFhnrvVw] [-L< 标 签 >] [-o< 选 项 >] [-t< 文 件 系 统 类 型 >] [设备 名 ] [ 挂 载 目 录 ] 


mount LFE RIER 
(自动 检测 ) 等 。mount 常 月 


统 类 型 包括 minix, Ext2. msdos, vfat, nfs, iso9660. ntfs, 
参数 和 选项 见 表 11-3. 


auto 


表 11-3 mount 命令 常用 参数 


$2 数 说 明 
-a 加 载 文件 /etc/fstab 中 设置 的 所 有 设备 
-f 不 实际 加 载 设备 。 可 与 -v 等 参数 同时 使 用 以 查看 mount 的 执行 过 程 
-F 需 与 -a 参数 同时 使 用 。 所 有 在 /etc/fstab 中 设置 的 设备 会 被 同时 加 载 ， 可 加 快 执行 速度 
-h 显示 在 线 帮助 信息 
-L< 标 签 > 加载 文件 系统 标签 为 < 标签 > 的 设备 
-n 不 将 加 载 信息 记录 在 /etc/mtab 文件 中 
-0< 选 项 > 旧 定 加 载 文件 系统 时 的 选项 。 有 些 选项 也 可 在 /etc/fstab 中 使 
E 以 只 读 方 式 加 载 设 备 
-t 旧 定 设备 的 文件 系统 类 型 
-v 执行 时 显示 详细 的 信息 
-V 显示 版 本 信息 
-w 以 可 读 写 模式 加 载 设备 ， 默 认 设 置 
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中 -o 最 重要 的 选项 见 表 11-4。 


表 11-4 mount 的 -o 参数 常用 选项 


选 项 说 明 
ro 以 只 读 模 式 加载 
TW 以 可 读 写 模式 加 载 ， 默 认 设置 
async 以 非 同步 的 方式 执行 文件 系统 的 输入 输出 动作 ， 默 认 设 置 
Sync 以 同步 方式 执行 文件 系统 的 输入 输出 动作 
suid 启动 set-user-identifier( 设 置 用 户 ID) 与 set-group-identifer( 设 置 组 ID) 设 置 位 
nosuid 关闭 set-user-identifier( 设 置 用 户 ID) 与 set-group-identifer( 设 置 组 ID) 设 置 位 
atime 每 次 存 取 都 更 新 inode 的 存 取 时 间 ， 默 认 设置 
noatime 每 次 存 取 时 不 更 新 inode 的 存 取 时 间 
remount 重新 加 载 设备 。 通 常用 于 改变 设备 的 设置 状态 
dev 可 读 文件 系统 上 的 字符 或 块 设备 
nodev 不 解析 文件 系统 上 的 字符 或 块 设备 
user 可 以 让 一 般 用 户 加 载 设备 
nouser 禁止 普通 用 户 执行 加 载 操 作 ， 默 认 设 置 
ERLER REH umount 命令 。 


umount [HER Hox] 


11.3. 虚拟 文件 系统 接口 


11.3.1 VFS 文件 接口 
VFS 提供 的 文件 操作 接口 如 下 : 


struct file *filp open(const char *filename, int flags, umode t mode) 
Ssize t vfs read(structfile *, char — user *, size t, loff t *); 

Ssize t vfs write(struct file *, const char — user *, size t, loff t *); 
int filp close(struct file *filp, fl owner t id); 


物理 文件 用 inode 表示 ， 打 开 的 文件 用 file 表示 。 打 开 的 文件 在 应 用 层 标记 为 文件 描述 


fj Cfile descriptor)。 应 用 层 调 用 open， 对 应 内 核 的 open 系统 调用 : 


SYSCALL DEFINE3(open, const char — user *, filename, int, flags, umode t, mode) 


1 
if(force o largefile()) 
flags = O LARGEFILE; 
return do sys open(AT FDCWD, filename, flags, mode); 
} 


do sys open 函数 代码 如 下 ; 


long do_sys_open(int dfd, const char — user *filename, int flags, umode t mode) 
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struct open flags op; 
int fd — build open flags(flags, mode, &op); 
struct filename *tmp; 
if (fd)return fd; 
tmp = getname(filename); 
if(IS ERR(tmp)) 
return PTR. ERR(tmp); 
fd = get unused fd flags(flags); 
if (fd >= 0) ( 
struct file *f= do filp open(dfd, tmp, &op); 
if(IS ERR(f)) { 
put unused fd(fd); 
fd = PTR ERR(f); 
} else ( 
fsnotify open(f); 
fd install(fd, f); 


j 


putname(tmp); 
return fd; 


j 


do sys open 函数 最 后 会 调用 do dentry open 函数 ， 其 中 有 对 file Zim cf 


进行 赋值 : 
static int do dentry open(struct file *f,struct inode *inode, 
int (*open)(struct inode *, struct file *),const struct cred *cred) 
ff op -fops get(inode-^i fop); 
j 
这 是 file 结构 的 文件 操作 接口 的 来 源 。 图 11-1 为 文件 操作 调用 关系 


P 


应 用 层 文件 操作 
Copen read write ioctl close) 


系统 调用 


块 设备 驱动 


VES 层 文件 操作 TOES 
Cvfs open vfs read vfs write vfs ioctl vfs close) 
file->f ops 


具体 文件 系统 层 文件 操作 存储 设备 


inode->f_ops 


图 11-1 文件 操作 调用 关系 


282 


FERME 


$113 块 设备 驱动 与 文件 系统 


例 11.2 在 内 核 中 访问 文件 
代 人 码 见 \samples\11block\11-2module appfile。 本 例 演 示 如 何在 内 核 中 访问 文件 系统 中 的 
文件 。 核 心 代码 如 下 : 


static int — init filerw module init(void) 


1 


struct file *fd-filp open("/home/fs.txt", O_RDWR | O NDELAY, 0); 
if(IS ERR(fd)) 
1 

printk("open /home/fs.txt failed n"); 

return -1; 


else 


ssize t len=0; 

printk("open fs.txt successfully"); 

char buffertmp[A |; 

loff t pos-0; 

mm segment t oldfs — get fs(); 

set fs(KERNEL DS);// 允 许 vfs write Ej vfs read 访问 内 核 地址 
memset(buffertmp,0,4); 

buffertmp[0]-0x31; 

len-vfs write(fd,buffertmp,1,&pos); 

printk("write buffertmp=%s,len=%d\n",buffertmp, len); 
memset(buffertmp,0,4); 


pos=0; 
vfs read(fd,buffertmp,1,&pos); 
printk("read buffertmp=%s\n",buffertmp); 
set_fs(oldfs); 
filp_close(fd,NULL); 

} 


return 0; 


vfs write 函数 的 第 二 个 参数 为 来 自用 户 空 间 的 地 址 ， 但 本 例 中 的 缓冲 来 自 内 核 空 间 ， 所 
以 需要 使 用 set fs 函数 来 设置 本 线程 的 地 址 上 限 为 KERNEL DS， 以 允许 vfs write 访问 
buffertmp。 文 件 访 问 结束 后 需 恢复 原先 的 地 址 上 限 。 本 例 运行 结果 如 下 : 


5 


[root(a)urbetter drivers |Zinsmod hello.ko 
open fs.txt successfully 

write buffertmp-1,len-1 

read buffertmp-1 


11.3.2 VFS 目录 接口 


目录 接口 包括 文件 创建 、 目 录 创 建 、 节 点 创建 、 链 接 、 删 除 目录 、 重 命名 等 。VFS 层 的 
目录 操作 接口 如 下 : 
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int vfs_create(struct inode *, struct dentry *, umode t, bool); 

int vfs mkdir(struct inode *, struct dentry *, umode t); 

int vfs mknod(struct inode *, struct dentry *, umode t, dev t); 

int vfs symlink(struct inode *, struct dentry *, const char *); 

int vfs link(struct dentry *, struct inode *, struct dentry *, struct inode **); 

int vfs rmdir(struct inode *, struct dentry *); 

int vfs unlink(struct inode *, struct dentry *, struct inode **); 

int vfs rename(struct inode *, struct dentry *, struct inode *, struct dentry *, struct inode **, unsigned int); 


int vfs whiteout(struct inode *, struct dentry *); 
I TY 


11.4 根 文件 系统 制作 


11.4.1 Busybox 


Busybox 是 一 个 集成 了 一 百 多 个 最 常用 Linux 命令 和 工具 的 软件 ， 甚 至 包括 一 个 http 服 
务 器 和 一 个 telnet 服务 器 。Busybox 就 像 一 个 集成 电路 ， 把 常用 的 工具 和 命令 压缩 在 一 个 可 
执行 文件 里 ， 功 能 基本 不 变 ， 而 大 小 却 小 很 多 ， 只 有 IMB £A, MARAR Linux 中 ， 
Busybox 有 非常 广泛 的 应 用 。Busybox 命令 的 用 法 如 下 : 


« 


/运行 busybox 中 的 1s 命令 

#busybox ls 

/建立 指向 busybox 的 链接 ,不 同 的 链接 名 完成 不 同 的 功能 
#ln -s busybox ls 

/然后 可 以 执行 这 个 链接 : 

#./ls 


K 11-5 为 Busybox 包括 的 儿 个 编译 选项 ， 可 以 帮助 用 户 编译 和 调试 Busybox。 


表 11-5 Busybox 提供 的 几 个 make 选项 


make 目标 说 明 
help 显示 make 选项 的 完整 列表 
defconfig 启用 默认 的 (通用 ) 配置 
allnoconfig 禁用 所 有 的 应 用 程序 〈 空 配置 ) 
allyesconfig 启用 所 有 的 应 用 程序 〈 完 整 配置 ) 
allbareconfig 启用 所 有 的 应 用 程序 ， 但 是 不 包括 子 特性 
config 基于 文本 的 配置 工具 
menuconfig N-curses (基于 菜单 的 ) 配置 工具 
all 编译 Busybox 二 进 制 文件 和 文档 C/docs) 
busybox 编译 Busybox 二 进 制 文件 
clean 清除 源 代 码 树 
distclean 彻底 清除 源 代 码 本 
sizes 显示 所 启用 的 应 用 程序 的 文本 /数据 大 小 
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Busybox 具有 可 剪裁 的 特点 。 对 于 有 特殊 需求 的 嵌入 式 设 备 ， 可 以 手工 使 用 make 
menuconfig 来 配置 Busybox 的 内 容 。make menuconfig 与 配置 Linux 内 核 的 内 容 所 使 用 的 目 
标 相 同 。make menuconfig 效果 如 图 11-2 所 示 。 


图 11-2 使 用 menuconfig 配置 Busybox 


Linux 在 加 载 根 文 件 系统 之 后 ， 紧 接着 执行 init 进程 。Busybox 中 的 init 进程 会 调用 
letc/inittab 等 脚本 文件 。Busybox 的 根 目 录 下 的 example 文件 夹 下 有 详尽 的 inittab 文件 范例 。 
inittab 文件 中 每 一 行 的 格式 如 下 所 示 : 


id:runlevel:action:process 


尽管 此 格式 与 传统 的 Sytem V init 类 似 , 但 是 ，id 在 Busybox 的 init 中 具有 不 同 的 意 
义 。 对 Busybox 而 言 ，id 用 来 指定 启动 进程 的 控制 ty。 如 果 所 启动 的 进程 并 不 是 可 以 交互 
的 shell， 例 如 Busybox 的 sh (ash)， 则 应 该 有 个 控制 ty， 如 果 控 制 tty 不 存在 ，Busybox 的 
sh 会 报错 。Busybox 将 会 完全 忽略 runlevel 字段 ， 所 以 该 字段 可 以 空 着 ， 这 是 为 了 和 传统 的 
Sytem V init 的 格式 保持 一 致 。process 字段 用 来 指定 所 执行 程式 的 路 径 ， 包 括 命令 行 选项 。 
action 字段 用 来 指定 表 11-6 中 8 个 可 应 用 到 process 的 动作 之 一 。 


表 11-6 inittab 文件 中 的 动作 说 明 
动作 说 ng) 
sysinit 为 init 提供 初始 化 命令 行 的 路 径 
respawn 每 当 相应 的 进程 终止 执行 便 会 重新 启动 


askfirst 类 似 respawn， 不 过 它 的 主要 用 途 是 减少 系统 上 执行 的 终端 应 用 程序 的 数量 。 它 将 会 促使 init 在 控制 台 上 显示 
“Please press Enter to active this console” 的 信息 ， 并 在 重新 启动 之 前 等 待 用 户 按 下 Enter 键 


wait 告诉 init 必须 等 到 相应 的 进程 完成 之 后 才能 继续 执行 
once 仅 执行 相应 的 进程 一 次 ， 而 且 不 会 等 待 它 完 
ctraltdel 当 按 下 Ctrl+Alt+Delete 组 合 键 时 ， 执 行 相应 的 进程 
shutdown 当 系统 关 机 时 ， 执 行 相应 的 进程 
Testart 当 init 重新 启动 时 ， 执 行 相应 的 进程 ， 通 常 此 处 所 执行 的 进程 就 是 init 本 身 
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下 面 介绍 如 何 编译 Busybox。 
C1) 修改 makefile: 


cross compile-arm-linux- 


(2) 执行 make menuconfig. JL module utilities Hox, Zh 2.4 内 核 的 模块 支持 ， 如 
图 11-3 所 示 。 


图 11-3 去掉 对 2.4 内 核 的 模块 支持 


(3) 执行 make。 
(4) 执行 make instal， 把 目标 文件 安装 到 ./ install 目录 。 


11.4.2 shell 基础 


shell 是 一 种 具备 特殊 功能 的 程序 ， 它 是 介 于 用 户 和 UNIX、Linux 等 操作 系统 核心 程序 
间 的 一 个 接口 。 常 见 的 shell 有 Bourne shell (/bin/sh), C shell (/bin/csh)、Korn shell 
(/bin/ksh)、Bourne again shell (/bin/bash)、Tenex C shell (tesh) 等 shell。UNIX/Linux 将 
shell 独立 于 核心 程序 之 外 ， 使 得 它 就 如 同一 般 的 应 用 程序 ， 可 以 在 不 影响 操作 系统 本 身 的 
情况 下 进行 修改 、 更 新 版 本 或 添加 新 的 功能 。shell 担任 的 工作 包括 : 读 取 输入 和 语法 分 析 
命令 列 、 处 理 信号 、 寻 找 程序 并 执行 。 无 论 哪 一 种 shell， 基 本 功能 与 作用 都 是 相同 的 ， 它 们 
之 间 的 不 同 在 于 对 同一 命令 的 处 理 顺 序 、 命 令 数 量 和 参数 格式 等 。 

Bash 是 一 种 常用 的 shell 程序 ， 它 具有 命令 记录 、 命 令 自动 补 全 、 命 令 别 名 (alias) 设 
定 功 能 、 工 作 控制 jobs)、 前 景 背景 控制 等 特点 。 命 令 记录 是 指 Bash 会 记录 命令 历史 。 命 
令 自 动 补 全 是 指 按 下 TAB 键 ，shell 会 补 全 命令 或 文件 名 的 后 部 分 内 容 。 每 次 打开 Bash HT, 
会 为 每 个 运行 Bash 的 用 户 执 行 /etc/bashrc 或 /etc/profile 脚本 。 它 设置 默认 提示 符 ， 可 以 添加 
一 个 或 更 多 别名 ， 为 所 有 用 户 设置 用 户 环境 信息 。 在 Bash 下 ， 可 以 通过 更 改 PSI 环境 变量 
的 值 来 设置 shell 提示 符 ， 例 如 : 
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$ export PS1=">" 
> 
$ export PS1="This is my super prompt > " 
This is my super prompt > 
$ export PS1="\u@\H >" 
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\u@\H > 表示 显示 当前 用 户 名 和 主机 名 。 结 果 如 下 ; 


root@localhost> 


K 11-7 是 Bash 可 识别 的 部 分 专用 序列 。 


表 11-7 Bash 专用 序列 


Æ 5 说 明 
\a ASCH 响 铃 字符 (BEL) 
d 当前 日 期 ，"Tue May 26" 格 式 
Ve ASCI 转 义 字符 
Wh 主机 名 的 第 一 部 分 (如 "fgj") 
\H 主机 的 全 称 〈 如 "fgj.mydomain.com") 
\n 换行 符 
v 可 车 符 
\s shell 的 名 称 〈 如 "bash") 
n 24 小 时 HH:MM:SS 格式 时 间 〈 如 22:01:01") 
TT 12 小 时 HH:MM:SS 格式 时 间 〈 如 10:01:30") 
\@ 带 有 am/pm 的 12 小 时 制 时 间 
\A 24 小 时 HH:MM 格式 时 间 
N 此 shell 的 终端 设备 名 (如 "ttySA0") 
y 此 shell 管理 的 job 数量 
u 当前 用 户 名 
Ww Bash 的 版 本 〈 如 3.2) 
Ww 当前 工作 目录 (如 "/home/fgj ") 
\W 当前 工作 目录 的 基 名 (basename) 
\! 当前 命令 在 历史 缓冲 区 中 的 位 置 
\# 命令 编号 (只 要 键入 内 容 ， 它 就 会 在 每 次 提示 时 累加 ) 
\$ 如 果 用 户 不 是 超级 用 户 (root)， 则 显示 一 个 "$"， 如 果 是 超级 用 户 ， 则 显示 一 个 "#" 
\nnn 插入 一 个 用 三 位 数 nnn《〈 用 零 代 替 未 使 用 的 数字 ， 如 "007 表示 的 ASCII 字符 


下 面 是 Bash 的 编译 步骤 : 


(1) 
(2) 


tar zxvf bash-3.2.tar.gz 


Jconfigure --host-arm-linux 


287 


Linux 驱动 程序 开发 实例 第 2 版 


(3) 使 用 make 编译 生成 的 bash 程序 


11.4.3. 根 文件 系统 构建 实例 


例 11.3 建立 根 文 件 系统 
(1) 生成 必要 的 目录 和 设备 文件 : 


echo "creatint rootfs dir...... 
mkdir rootfs 

cd rootfs 

mkdir bin dev etc lib proc sbin sys usr 

mkdir usr/bin usr/lib usr/sbin lib/modules 
mkdir mnt tmp var 

chmod 1777 tmp 

mkdir mnt/u mnt/v 

mkdir var/lib var/lock var/log var/run var/tmp 
chmod 1777 var/tmp 

mkdir home root boot 

mknod -m 600 dev/console c 5 1 

mknod -m 666 dev/null c 1 3 

echo "done" 


(2) 建立 /etc 目录 的 文件 Cinitab. profile, passwd 45:5. 

(3) 添加 busybox 文件 (在 busybox 下 的 ./_install 目录 中 ) 到 目录 中 。 

(4) 把 编译 生成 的 bash 程序 复制 到 目标 板 根 文 件 系统 的 /bin 目录 下 ， 修 改 /etc/inittab: 
::askfirst:-/bin/bash 

(5) 编译 安装 库 文件 glibc/uclibc。 库 文件 也 可 从 编译 工具 的 库 目录 中 复种 


AR 
o 


11.4.4 添加 mdey 


本 节 介 绍 busybox 1.8.2 中 包含 的 mdev， 它 是 udev HRA RIRE. 
(1) 进入 busybox 目录 修改 MAKEFILE， 将 Makefile 中 的 ARCH 和 CROSS_COMPILE 
修改 为 arm 系列 : 


ARCH ?= arm 
CROSS COMPILE ?= arm-linux- 


(2) 配置 busybox。 运 行 make menuconfig， 选 择 需 要 的 选项 。 选 择 完毕 ， 编 译 时 出 现 如 
下 错误 : 


undefined reference to 'query module' 


解决 方法 是 执行 make menuconfig 后 ， 进 入 Module THE, AHX) 2.4 WERE SE 
持 ， 如 图 11-3 所 示 。 

(3) 保存 后 运行 make 和 make install. 

(4) 将 生成 的 目标 文件 复制 到 文件 系统 中 ， 测 斌 结果 如 下 : 
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[root(2) (none) dev | Is 

console null pts shm 
[root@ (none) dev |? /sbin/mdev -s 
[root(2) (none) dev |? ls 

console ptys4 

full ptys5 

kmem ptysó 

kmsg ptys7 

md0 ptys8 

mem ptys9 

mice ptysa 

实际 应 有 


/sbin/mdev —s 


Zero 


tty19 
tty2 

tty20 
tty21 
tty22 
tty23 
tty24 


y» 


ttyq9 


ttyqb 
ttyqc 
ttyqd 
ttyqe 
ttyqf 


最 后 还 应 设置 mdev 为 默认 的 uevent helper 程序 : 


echo /sbin/mdev > /proc/sys/kernel/hotplug 


11.5 NFS 根 文件 系统 搭建 


网 络 文件 系统 NFS) 是 一 种 通过 网 络 共享 文件 的 机 制 ， 通 过 NFS， 远 程 的 文件 可 以 像 
本 地 文件 一 样 访问 。 网 络 文件 系统 是 一 种 服务 器 与 客户 端 结构 ， 客 户 端 通过 mount 方式 加 载 
网 络 文件 系统 。 


首先 应 该 在 Linux 主机 上 安装 NFS 服务 器 : 


sudo apt-get install nfs-kernel-server 


/etc/exports, 


配置 如 下 : 


/root/fgj/nfs *(rw,sync,no root squash,no subtree check) 


重新 局 


动 NFS 服务 ， 让 


sudo /etc/init.d/rpcbind restart 


目录 生效 : 


sudo /etc/init.d/nfs-kernel-server restart 


一 般 安装 完 NFS server H 


最 好 关闭 主机 的 防火 墙 。 


例 11.4 
d) mH 


建立 NFS 根 文 件 系统 
保 内 核 包含 网 络 设备 对 

(2) 配置 内 核 支 持 NFS 文 伯 
> [Network File Systems] "ix E nk 


HEWER 


下 次 重启 3 


名 


区 动 程序 。 
EF 系统 和 NFS 块 设备 、NFS 


11-4 所 示 


第 11 章 


建立 NFS 服务 目录 /oot/fgj/nfs/rootfs， 将 根 文 件 系统 的 文 伯 


块 设备 驱动 与 文件 系统 


j 中 可 以 修改 系统 启动 脚本 ， 增 加 如 下 语句 ， 让 mdev 开机 自动 运行 。 


F 全 部 复制 到 该 目录 。 打 开 


机 会 自动 启动 NFS 服务 。 另 外 使 用 NFS 时 


ROC] 


E [File systems] - 
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—- Network File Systems 
Sk»? — NFS client support 


ek NFS client support for NFS version 2 

ek NFS client support for NFS version 3 

[*] NFS client support for the NFSy3 ACL protocol extension 
EC ga NFS client support for NFS version 4 

[ ] Prowide swap over NFS support 


] NFS client support for NFSv4.1 
] Root file system on NFS 

] Use the legacy NFS DNS resolver 
> NFS serwer support 

] RPC: Enable dprintk debugging 

>  Qeph distributed file system 


图 11-4 配置 内 核 支 持 NFS 


在 【device drivers ] -> [Block devices】 中 设置 如 网 11-5 所 示 : 


——- Block devices 

$5 Null test block driver 

S*» Loopback device support 

(8) Number of loop devices to pre-create at init time 
<> Cryptoloop Support 

< » DRED Distributed Replicated Block Device support 
«k> — Network block device support 

< 站 > RAM block device support 

(161 Default number of RAM disks 

(d086) Default RAM disk size lkbytez) 

<> Packet writing on CD/DVD media 


图 11-5 配置 内 核 支 持 NFS 块 设备 
(3) 修改 内 核 启 动 参数 : 


setenv — bootargs "root=/dev/nfs nfsroot=192.168.10.102:/root/fgj/nfs/rootfs ip=192.168.10.103: 
192.168.10.102:192.168.10.1:255.255.255.0:www:ethO0:off console-ttySAC0,115200" 


其 中 root=/dev/nfs， 并 非 真 的 设备 ， 而 是 告诉 内 核 通 过 网 络 取得 根 文件 系统 。 参 数 


nfsroot 告诉 内 核 以 哪 一 台 计 算 机 ， 哪 个 目录 以 及 哪个 网 络 文件 系统 选项 作为 根 文件 系统 使 
用 。 参 数 的 格式 如 下 : 


T 


nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>] 


如 果 指 令 列 上 没有 给 定 nfsroot 参数 ， 则 将 使 用 /tftpboot/%s 预 设 值 。 其 他 选项 如 下 : 

<server-ip> -- 指 定 网 络 文件 系统 服务 端的 互联 网 地 址 (IP address)。 如 果 没 有 给 定 此 字 
段 ， 则 使 用 由 nfsaddrs 变量 所 决定 的 值 。 此 参数 的 用 途 之 一 是 允许 使 用 不 同 计算 机 作为 反 
向 地 址 解析 协议 (RARP) 及 网 络 文件 系统 服务 端 ， 通 常 可 以 设 为 空白 。 

«root-dir- -- 服务 端 上 要 作为 根 挂 入 的 目录 名 称 。 如 果 字 串 中 有 个 %s 标识 符 (token)， 
此 符 记 将 代 换 为 客户 端 互联 网 地 址 之 ASCI 表示 法 。 

<nfs-options> -- 标准 的 网 络 文件 系统 选项 。 所 有 选项 都 以 逗号 分 开 。 如 果 没有 给 定 此 选 
项 字段 则 使 用 下 列 的 预 设 值 : 


port- as given by server portmap daemon 
rsize — 1024 
wsize- 1024 


timeo- 7 
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retrans= 3 

acregmin= 3 

acregmax- 60 

acdirmin- 30 

acdirmax- 60 

flags — hard, nointr, noposix, cto, ac 


参数 ip= 的 格式 如 下 : 
ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf> 


它 告诉 内 核 如 何 配置 设备 的 PP 地 址 ， 如 何 建立 IP 路 由 表 。<client-ip> 是 客户 IP, 
<server-ip> 是 NFS 服务 器 IP，<gw-ip> 是 网 关 IP，<netmask> 是 掩 码 ，<hostname> 是 客户 主机 
名 。<device> 是 网 络 设备 名 。<autocon 他 在 单独 作为 ip 的 值 时 起 作用 〔( 它 之 前 没有 任何 ":" 
号 ， 如 : "ip=off' 或 "ip=none" 等 )， 如 果 "ip=off' 或 "ip=none"， 表 示 不 启用 自动 配置 。 
<autocon 他 有 如 下 值 


offornone: ”不 启用 自动 配置 ，IP 静态 指定 

on orany: ”使 用 内 核 中 可 用 的 任何 自 配 置 协 议 

dhcp: 使 用 DHCP 

bootp: 使 用 BOOTP 

rarp: 使 用 RARP 

both: 使 用 BOOTP 和 RARP ， 但 不 使 用 DHCP 


运行 后 发 现 eth0 没有 自动 激活 。 观 察 到 局 动 参数 中 有 ip 参数 : 
ip-192.168.10.103:192.168.10.102:192.168.10.1:255.255.255.0:www:ethO:off 


查找 内 核 中 有 如 下 语句 : 


. setup("ip=", ip auto config setup); 
. setup("nfsaddrs-", nfsaddrs config setup); 


跟踪 代码 发 现 ip auto config setup 没有 执行 ， 说 明 需 要 在 内 核 中 设置 P 自动 配置 协议 
xio MA [Networking support] -> [Networking options], "ul 11-6 所 示 。 


而 


] Transformation migrate database 
Transformation statistics 

< > PF KEY sockets 

[ TE F networking 

: multicasting 

: advanced router 

FIE TRIE statistics 

IF: policy routing 

IP: equal cost multipath 

F: verbose route monitoring 
: kernel level autoconfiguration 
br IP: DHCP support 

[+] F: BOOTP support 

IF: RARP support 

< 本 > IP: tunneling 

$2 P: GRE demultiplexer 

IP: multicast routing 


d H 
"d td 


* 
"d 


图 11-6 选择 内 核 级 别 的 自动 TP. 配置 
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配置 完毕 ， 根 文件 系统 可 以 加 载 。 运 行 结果 如 下 : 


dm9000 dm9000.0: WARNING: no IRQ resource flags set. 
dm9000 dm9000.0 eth0: link down 

usb 1-2: device not accepting address 4, error -62 

usb 1-2: new full-speed USB device number 5 using s3c2410-ohci 
usb 1-2: device not accepting address 5, error -62 


usb usb1-port2: unable to enumerate USB device 
IP-Config: Complete: 
device-eth0, hwaddr-00:e0:a3:24:98:67, ipaddr-192.168.0.103, mask-255.255.255.0, 
gw-192.168.0.1 
host2www, domain-, nis-domain-(none) 
bootserver-192.168.0.102, rootserver-192.168.0.102, rootpath- 
ALSA device list: 
#0: SMDK WM9713 
dm9000 dm9000.0 eth0: link up, 100Mbps, full-duplex, lpa 0x45E1 
VFS: Mounted root (nfs filesystem) on device 0:11. 
Freeing unused kernel memory: 204K (c0635000 - c0668000) 
mount: mounting none on /proc/bus/usb failed: No such file or directory 
LELLLLLLLLLLLLELELLLLLLLELELLLLLLLLLLIII 
Welcome to Root FileSystem! 
http://www.urbetter.com 
LLLLLLLLLLLLLLLELLLLLLLELLELLLLLLLLLLIII 
Starting Qtopia, please waiting... 
Please press Enter to activate this console. touch... 


[root(Qjurbetter ~]# df 

Filesystem 1K-blocks Used Available Use% ^ Mounted on 

192.168.0.102:/root/fgj/nfs/rootfs — 29799484 10941344 17321372 3996 / 

tmpfs 61528 0 61528 0% /dev/shm 
[root(Q)urbetter ~]# ls 

bin etc lib mnt proc sbin Sys udisk var 

dev home linuxrc opt root sdcard tmp usr 

[root@urbetter ~]# 


可 见 NFS 文件 系统 已 经 加 载 到 根 目 录 下 。 
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NAND Flash ERA GX Ae UHR. AREAS Linux 内 核 、 文 件 
系统 等 。NAND Flash 驱动 是 一 种 基于 MTD 架构 的 复合 型 驱动 ， 既 是 字符 型 驱动 ， 也 是 块 
设备 驱动 。 本 章 介 绍 MTD 设备 层 与 NAND Flash 驱动 开发 。 


12.4 MID 设备 层 


12.1.1 MTD 架构 


ERAIÑ Linux 中 ，MTD (Memory Technology Device) 为 底层 硬件 《闪存 等 ) 和 上 层 
(文件 系统 ) 之 间 提 供 一 个 统一 的 抽象 接口 ， 这 样 就 可 以 在 Flash 上 建立 基于 MTD 驱动 层 的 
文件 系统 。 使 用 MTD 驱动 程序 的 主要 优点 在 于 ， 它 是 专门 针对 各 种 非 易 失 性 存储 器 而 设计 
的 ， 因 而 它 对 Flash 有 更 好 的 支持 ， 并 包含 了 基于 遍 区 的 擦 除 、 读 / 写 操作 接口 。 图 12-1 是 
MTD 系统 的 层次 结构 图 。 


Ni 


/dev/mtdn /dev/mtdblockn 


MTD 层 ”| MTD 原 始 设 备 


NOR/NAND FLASH 控 制 器 驱动 


图 12-1 MTD 层次 结构 

MTD 层 包 含 了 MTD 原始 设备 和 MTD 设备 层 。MTD 设备 层 基 于 MTD 原始 设备 ， 它 包 
括 MTD 字符 设备 与 MTD 块 设备 。 用 于 描述 MTD 原始 设备 的 数据 结构 是 mtd info, CAR 
了 大 量 关 于 MTD 的 操作 接口 函数 。 


struct mtd info { 
u char type; 
uint32 t flags; 
uint64 tsize; // MTD 总 大 小 
uint32 t erasesize;// 擦 写 单元 大 小 
uint32 t writesize; // 写 单元 大 小 
uint32 t writebufsize;/ 写 缓冲 大 小 
uint32 toobsize; /每 个 block 中 的 OOB 数据 大 小 
uint32 toobavail; /每 个 block 中 可 用 的 OOB 大 小 
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unsigned int erasesize shift; 

unsigned int writesize shift; 

unsigned int erasesize mask; 

unsigned int writesize mask; 

unsigned int bitflip threshold 位 反 转 阔 值 ， 超 过 则 返回 -EUCLEAN 
const char *name;// 名 称 


int index; 
struct nand_ecclayout *ecclayout;//ECC 布局 
unsigned int ecc_step_size;//ECC step 大 小 
I*A ECC step 允许 的 最 大 可 修复 位 */ 
unsigned int ecc. strength; 

// 擦 写 区 信息 


int numeraseregions; 


struct mtd erase region info *eraseregions; 
/回调 函数 


int (* erase) (struct mtd info *mtd, struct erase info *instr); 


int (* read) (struct mtd info *mtd, loff t from, size tlen,size t *retlen, u_char *buf); 
int (* write) (struct mtd info *mtd, loff t to, size t len,size t *retlen, const u char *buf); 


int (* read oob) (struct mtd info *mtd, loff t from,struct mtd oob ops *ops); 
int (* write oob) (struct mtd info *mtd, loff t to,struct mtd oob ops *ops); 


int (* writev) (struct mtd info *mtd, const struct kvec *vecs, 
unsigned long count, loff t to, size t *retlen); 

void (* sync) (struct mtd info *mtd); 

int (* lock) (struct mtd info *mtd, loff t ofs, uint64 t len); 

int (* unlock) (struct mtd info *mtd, loff t ofs, uint64 t len); 

int (* is locked) (struct mtd info *mtd, loff t ofs, uint64 t len); 

int (* block isreserved) (struct mtd info *mtd, loff t ofs); 

int (* block isbad) (struct mtd info *mtd, loff t ofs); 

int (* block markbad) (struct mtd info *mtd, loff t ofs); 

int (* suspend) (struct mtd info *mtd); 

void (* resume) (struct mtd info *mtd); 

void (* reboot) (struct mtd info *mtd); 

/引用 计数 维护 


int (* get device) (struct mtd info *mtd); 


void (* put device) (struct mtd info *mtd); 

struct backing dev info *backing dev info;/ 后 备 存储 设备 
struct notifier block reboot notifier:/ 重 启 通知 链 

struct mtd. ecc stats ecc stats; /*ECC 状态 */ 

intsubpage sft; /* F JL [i f (NAND)*/ 

void *priv; 


struct module *owner; 
struct device dev;// 对 应 的 设备 
int usecount; 
je 
mtd device parse register 函数 用 于 解析 分 区 (mtd_partition)， 并 注册 MTD 原始 设备 : 
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int mtd device parse register(struct mtd info *mtd, const char * const *types, 
struct mtd part parser data *parser data, 
const struct mtd partition *parts,int nr parts); 


mtd device unregister 函数 用 来 注销 一 个 MTD 原始 设备 : 


int mtd device unregister(struct mtd info *master); 


MTD 原始 设备 的 基本 操作 包括 以 下 函数 : 


int mtd. read(struct mtd info *mtd, loff t from, size_t len, size_t *retlen;u char *buf);// 读 
int mtd write(struct mtd info *mtd, loff t to, size t len, size t *retlen,const u_char *buf);//5j 


int mtd read oob(struct mtd info *mtd, loff t from, struct mtd oob ops *ops); / 读 OOB 
int mtd block markbad(struct mtd. info *mtd, loff t ofs); // 标 记 坏 块 

int mtd block isbad(struct mtd info *mtd, loff t ofs);// 是 否 坏 块 
int mtd erase(struct mtd info *mtd, struct erase info *instr); // 擦 除 块 


由 于 Linux 系统 中 的 MTD 设备 包含 了 块 设备 和 字符 设备 两 个 方面 ， 对 MTD 设备 的 操 


作 ， 首 先 要 区 分 是 以 块 设备 方式 还 是 以 字符 设备 的 方式 。 下 面 是 MTD 设备 的 主 设备 号 : 


#define MID CHAR MAJOR 90 
#define MTD BLOCK MAJOR 31 


以 下 是 /dev 目录 下 的 MTD 设备 节点 ，mtdn 和 mtdnro 代表 字符 设备 。mtdblockn 代表 块 


设备 。 


root@/dev]#ls | grep mtd 


mtd0 mtdOro mtd1 mtdlro 
mtd2 mtd2ro mtd3 mtd3ro 
mtdblock0 mtdblock1 mtdblock2 mtdblock3 


12.1.2 MTD 字符 设备 


MTD 字符 设备 的 实现 在 mtdchar.c 文件 中 。 下 面 是 MTD 字符 设备 的 注册 代码 : 


static const struct file operations mtd fops — ( 


.owner = THIS MODULE, 

.seek = mtdchar lseek, 

read — mtdchar read, 

.Write — mtdchar write, 

unlocked ioctl = mtdchar unlocked ioctl, 


#ifdef CONFIG COMPAT 
.compat ioctl= mtdchar compat ioctl, 


#endif 
.Open = mtdchar open, 
release — mtdchar close, 
.mmap = mtdchar mmap, 


#ifndef CONFIG MMU 
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.get unmapped area = mtdchar get unmapped area, 
.mmap capabilities = mtdchar mmap capabilities, 


#endif 
B 
int initinit mtdchar(void) 
{ 
int ret; 


/申请 1 << MINORBITS ^ MTD 字符 设备 
ret= _register_chrdev(MTD_ CHAR MAJOR, 0, 1 << MINORBITS,"mtd", &mtd fops); 
if (ret < 0) { 

pr err("Can't allocate major number %d for MTD\n", MTD CHAR MAJOR); 


return ret; 

j 

return ret; 
j 
void exit cleanup mtdchar(void) 
1 

. unregister chrdev/:MTD CHAR MAJOR, 0, 1 << MINORBITS, "mtd"); 
j 


register chrdev 函数 创建 并 注册 一 系列 主 设备 号 相同 次 设备 号 顺序 增长 的 字符 设备 。 


前 面 章节 中 的 register chrdev region 函数 就 是 基于 ”register_chrdev 函数 。 内 核 添 加 MTD 原 
始 设备 时 会 注册 一 个 MTD 字符 设备 : 


#define MTD DEVT(index) MKDEV(MTD CHAR MAJOR, (index)*2) 
int add mtd device(struct mtd info *mtd) 


1 
i= idr alloc(&mtd idr, mtd, 0, 0, GFP KERNEL);// 分 配 一 个 ID 


mtd--index = i; 


mtd->dev.type = &mtd devtype; 

mtd->dev.class = &mtd class; 

mtd-»dev.devt = MTD. DEVT(i);//MTD 设备 号 

dev set name(&mtd--dev, "mtd*/d", i); 

dev set drvdata(&mtd-^dev, mtd); 

of node get(mtd get of node(mtd)); 

/注册 MID 字符 设备 ， 会 创建 /sys 设备 节点 ,并 引起 mdev 创建 /dev 设备 节点 


error = device register(&mtd->dev); 


if (error)goto fail added; 
/创建 ro 设备 节点 ， 次 设备 号 为 奇数 
device create(&mtd class, mtd->dev.parent, MID DEVT(Q) + 1, NULL,"mtd%dro", i); 


} 
MTD 字符 设备 打开 时 通过 次 设备 号 寻找 分 区 相应 的 原始 设备 结构 (mtd_info)。MTD 字 
符 设 备 打 开 函 数 如 下 ; 
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static int mtdchar open(struct inode *inode, struct file *file) 


1 


outl: 


out: 


int minor = iminor(inode); 
int devnum = minor >> 1; 
int ret = 0; 
struct mtd info *mtd; 
struct mtd file info *mfi; 
pr debug("MTD open\n"); 
FREH RW 方式 打开 RO 设备 */ 
if ((file->f mode & FMODE WRITE) && (minor & 1)) 
return -EACCES; 
mutex lock(&mtd mutex); 
mtd = get mtd device(NULL, devnum);// 获 得 mtd info 结构 
if(IS ERR(mtd)) { 
ret - PTR. ERR(mtd); 
goto out; 


j 
if (mtd-^type == MTD ABSENT) { 
ret --ENODEV; 
goto outl; 
j 
此 判断 是 否 用 RW 方式 打开 不 可 写 设备 */ 
if ((file->f mode & FMODE WRITE) && !(mtd->flags & MTD WRITEABLE)) { 


ret= -EACCES; 
goto outl; 
} 
mfi = kzalloc(sizeof(*mfi), GFP KERNEL); 
if (!mfi) { 
ret --ENOMEM; 
goto outl; 
j 


mfi->mtd = mtd; 
file-72private data = mfi; 
mutex unlock(&mtd mutex); 
return 0; 


put mtd device(mtd); 


mutex unlock(&mtd mutex); 
return ret; 


) /*mtdchar open*/ 


B 


, 


F 面 的 命令 完成 对 Flash 的 第 四 个 分 区 的 擦 写 : 


#flash_ eraseall /dev/mtd3 


BEAL 


符 设 
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例 12.1 MTD 字符 设备 的 基本 文件 操作 
下 面 是 mtd-utils 工具 包 中 flash erase 工具 的 部 分 代码 ， 演 示 了 MTD 字符 设备 的 典型 文 
件 操作 。 
static const char *mtd. device;Wmtd 字符 设备 文件 名 ， 如 /dev/mtd4 


libmtd t mtd desc; 
struct mtd dev info mtd; 


int main(int argc, char *argv[]) 
1 
mtd desc = libmtd open(); 
if (mtd desc — NULL) 
return errmsg("can't initialize libmtd"); 
if ((fd = open(mtd device, O RDWR)) < 0) 
return sys errmsg(" os", mtd device); 
if(mtd get dev info(mtd desc, mtd device, &mtd) < 0)/ 获 取 设 备 信息 
return errmsg("mtd get dev info failed"); 
if (jffs2 && mtd.type = MTD MLCNANDFLASH) 
return errmsg("JFFS2 cannot support MLC NAND."); 
eb start — start / mtd.eb size; 
isNAND = mtd.type == MTD NANDFLASH || mtd.type == MTD MLCNANDFLASH; 
if(eb cnt — 0) 
eb cnt = (mtd.size / mtd.eb size) - eb start; 
for (eb — eb start; eb < eb start + eb cnt; eb++) { 
offset — (off t)eb * mtd.eb size; 
if (Inoskipbad) ( 
intret = mtd is bad(&mtd, fd, eb);// 是 否 坏 块 
if (ret > 0) { 
verbose(!quiet, "Skipping bad block at %08"PRIxoff t, offset); 
continue; 
} else if (ret < 0) ( 
if (errno == EOPNOTSUPP) { 
noskipbad = 1; 
if IsNAND) 
return errmsg(" 96s: Bad block check not available", mtd device); 


) else 
return sys errmsg("?os: MTD get bad block failed", mtd device); 


j 
show. progress(&mtd, offset, eb, eb start, eb_cnt);// 显 示 进 度 
if (unlock) { 
if (mtd unlock(&mtd, fd, eb) != 0) ( 
sys errmsg("96s: MTD unlock failure", mtd device); 


continue; 


} 
if (mtd erase(mtd desc, &mtd, fd, eb) != 0) { 
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sys_errmsg("%s: MTD Erase failure", mtd device); 
continue; 
} 
放 写 入 清空 标记 */ 
if (isNAND) { 
if (mtd write oob(mtd desc, &mtd, fd, (uint64 t)offset +  clmpos, clmlen, 


&cleanmarker) != 0) 


sys errmsg("96s: MTD writeoob failure", mtd device); 
continue; 
} 
) else { 
if (pwrite(fd, &cleanmarker, sizeof(cleanmarker), (loff t)offset) !— sizeof(cleanmarker)) { 
sys errmsg(" 96s: MTD write failure", mtd. device); 


continue; 


j 


verbose(!quiet, " Cleanmarker written at Vo" PRIxoff t, offset); 


j 


show progress(&mtd, offset, eb, eb start, eb cnt); 
bareverbose(!quiet, n"); 
return 0; 


} 
mtd erase 函数 调用 MEMERASE IOCTL 来 擦 除 Flash， 具 体 实 现 如 下 : 


int mtd erase(libmtd t desc, const struct mtd dev info *mtd, int fd, int eb) 
1 
int ret; 
struct libmtd *lib = (struct libmtd *)desc; 
struct erase info user64 ei64; 
struct erase info user ei; 
ret — mtd valid erase block(mtd, eb); 
if (ret) 
return ret; 
ei64.start = ( u64)eb * mtd->eb size; 
ei64.length = mtd->eb size; 
/如 果 文 持 64 位 地 址 
if (lib->offs64 ioctls — OFFS64 IOCTLS SUPPORTED || 
lib-^offs64 ioctls — OFFS64 IOCTLS UNKNOWN) ( 
ret = ioctl(fd, MEMERASEÓ6A, &e164); 
if (ret == 0) 
return ret; 
if (errno != ENOTTY || 
lib->offs64 ioctls != OFFS64 IOCTLS UNKNOWN) 
return mtd 1octl error(mtd, eb, 'MEMERASE64"); 
// MEMERASE64 从 Linux 2.6.31 才 开始 支持 
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lib->offs64 ioctls = OFFS64 IOCTLS NOT SUPPORTED; 
} 
if (e164.start + ei64.length > OxFFFFFFFF) { 
errmsg("this system can address only %u eraseblocks",O0xFFFFFFFFU /mtd->eb size); 
errno = EINVAL; 
return -1; 
} 
ei.start = ei64.start; 
ei.length = e164.length; 
ret = ioctl(fd, MEMERASE, &ei); 
if (ret < 0) 
return mtd ioctl error(mtd, eb, "MEMERASE"); 
return 0; 


12.1.3 MTD 块 设备 


MTD 块 设备 的 驱动 程序 在 mtdblock.c 文件 中 实现 。MTD 块 设备 使 用 mtd blktrans dev 
划 述 。 该 结构 将 MTD 原始 设备 (mtd info) 与 存储 分 区 〈gendisk) 联系 在 一 起 。 


struct mtd blktrans dev { 
struct mtd blktrans ops *tr//MTD 块 传输 操作 
struct list head list; 
struct mtd info *mtd;// 关 联 的 mtd info 结构 
struct mutex lock; 
int devnum; 
bool bg stop; 
unsigned long size; 
int readonly; 
int open; 
struct kref ref; 
struct gendisk *disk;// 分 区 结构 
struct attribute group *disk_attributes;// 属 性 组 
struct workqueue struct *wq; 


s 
A 


struct work struct work; 

struct request queue *rq;// 请 求 队列 
spinlock t queue lock; 

void *priv; 

fmode t file mode; 


Us 
下 面 介绍 MTD 块 设 备注 册 过 程 。 首 先 注 册 MTD 块 传输 。 


static struct mtd blktrans ops mtdblock tr — { 


.name = "mtdblock", 
.major =MTD BLOCK MAJOR//MTD 块 设备 号 
.part bits = 0, 
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.blksize = 512, 

.Open = mtdblock open, 
.flush — mtdblock flush, 
release — mtdblock release, 
.readsect — mtdblock readsect, 
.Writesect = mtdblock writesect, 


.add mtd — mtdblock add mtd, 
remove dev- mtdblock remove dev, 


.owner = THIS MODULE, 
5 
static int imt init mtdblock(void) 
1 
return register mtd blktrans(&mtdblock tr); 
j 


register mtd blktrans 函数 中 调用 了 register blkdev P ZIGH 


int register mtd blktrans(struct mtd blktrans ops *tr) 
1 
struct mtd info *mtd; 
int ret; 
if ('blktrans notifier.list.next) 
register mtd user(&blktrans notifier); 
mutex lock(&mtd table mutex); 


E 


$123 


EJ EC 6 


ret = register blkdev(tr-^major, tr->name);// 注 册 块 设备 


if (ret < 0) { 
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printk(KERN WARNING "Unable to register os block device on major %d: %d\n", 


tr-7name, tr->major, ret); 
mutex unlock(&mtd table mutex); 
return ret; 
j 
if (ret) 
tr-^major = ret; 
tr->blkshift = ffs(tr-^blksize) - 1; 
INIT LIST HEAD(&tr-^devs); 
list add(&tr-^list, &blktrans majors); 
mtd for each device(mtd) 
if (mtd-^type != MTD ABSENT) 
tr-^add mtd(tr, mtd); 
mutex unlock(&mtd table mutex); 
return 0; 


j 


从 上 面 可 见 ， 注 册 mtdblock tr 时 调用 了 mtdblock tr 结构 的 add mtd 成 员 函 数 ， 也 就 是 


mtdblock add mtd 函数 。 


MTD 层 有 一 个 mtd notifier 结构 ， 用 于 描述 MTD 通知 链 。 
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struct mtd notifier ( 
void (*add)(struct mtd info *mtd); 
void (*remove)(struct mtd info *mtd); 
struct list head list; 
h 
register mtd blktrans 函数 中 添加 了 一 个 名 为 blktrans_notifier 的 mtd. notifier. 


static struct mtd notifier blktrans notifier — ( 
.add = blktrans notify add, 
remove = blktrans notify remove, 
h 
跟踪 blktrans notify add 发 现 ， 该 函数 调用 了 mtd blktrans ops 的 add mtd 成 员 ， 实 际 上 
就 是 mtdblock add mtd. 
另外 MTD 原始 设备 添加 函数 add mtd device 〈 见 上 文 ) 会 调用 内 核 中 所 有 mtd notifier 
结构 的 add 接口 ， 所 以 也 会 调用 mtdblock add mtd: 


int add mtd device(struct mtd info *mtd) 


1 


list for each entry(not, &mtd notifiers, list) 
not-^add(mtd); 


j 


也 就 是 说 ， 添 加 MTD 原始 设备 时 必定 会 调用 mtdblock tr 的 add mtd 成 员 (mtdblock add | 
mtd). mtdblock add mtd 函数 代码 如 下 ; 


static void mtdblock add mtd(struct mtd blktrans ops *tr, struct mtd info *mtd) 
1 
struct mtdblk dev *dev = kzalloc(sizeof(*dev), GFP KERNEL); 
if (!dev) 
return; 
dev-^mbd.mtd = mtd; 
dev--mbd.devnum = mtd->index; 
dev->mbd.size = mtd->size >> 9; 
dev->mbd.tr = tr; 
if (!(mtd->flags & MTD WRITEABLE)) 
dev->mbd.readonly = 1; 
if (add mtd blktrans dev(&dev->mbd)) 
kfree(dev); 
} 


mtdblock add mtd 函数 调用 add mtd blktrans dev 为 MTD 原始 设备 添加 了 一 个 分 区 
(Cgendisk)， 这 就 是 MTD 块 设备 的 由 来 。 


int add mtd blktrans dev(struct mtd blktrans dev *new) 


302 


第 12 章 NAND Flash 驱动 


gd=alloc disk(1 << tr-^part bits); 

if (!'gd)goto error2; 

new-»disk = gd; 

gd->private data = new; 

gd->major = tr-^major; 

gd->first_minor = (new->devnum) << tr->part_bits; 
gd->fops = &mtd block ops; 

set capacity(gd, ((u64)new-»size * tr-^blksize) >> 9); 


add disk(gd); 
} 


MTD 块 设备 节点 一 般 类 似 于 /dev/mtdblockn。 加 载 MTD 设备 就 是 对 MTD 块 设备 进行 操 
Eo MTD 分 区 的 定义 类 似 下 面 代码 : 


static struct mtd partition rx1950 nand part[]={ 
[0] - 1 
.name = "BootO", 
.offset = 0, 
.size = 0x4000, 
.mask flags = MTD WRITEABLE, 


.name = "Bootl", 

.offset = MTDPART OFS APPEND, 
.size = 0x40000, 

.mask flags = MTD WRITEABLE, 


.name = "Kernel", 

.offset = MTDPART OFS APPEND, 
.Size = 0x300000, 

.mask flags = 0, 


.name = "Filesystem", 

.offset = MTDPART_OFS_APPEND, 
.size = MTDPART SIZ FULL, 

.mask flags = 0, 


信息 包含 了 起 始 地 址 、 分 区 大 小 、 分 区 读 写 标志 等 。MTDPART OFS APPEND X 
示 从 上 一 分 区 结束 处 开始 。mtd_add_device_partitions 函数 为 MTD 设备 添加 分 区 : 


LH 


static int mtd add device partitions(struct mtd info *mtd,struct mtd partitions *parts); 
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进一步 分 析 mtd add device partitions 函数 ， 可 发 现存 在 如 下 调用 关系 : mtd add device - 
partitions->add mtd partitions-»add mtd device. add mtd device 函数 在 MTD 设备 驱动 中 扮 
演 重 要 角色 ， 负 责 创 建 MTD 字符 设备 与 MTD 块 设备 。 


12.2 NAND Flash 驱动 层 概 述 


122.1 硬件 原理 
S3C6410X 的 Flash 控制 器 原理 如 图 12-2 所 示 。 


nCS[3:2] 
ECC Gen. CLE 
ALE 
SFR NAND FLASH FREn 
P m Interface FWEn 
ontro 
! RnB 


Stave I/F 


Stepping Stone Stepping Stone 


Controller (8KB SRAM) 


É 12-2 S3C6410X 的 Flash 控制 器 


CS 为 片 选 ， 决 定 了 NAND FLASH 的 地 址 空间 ，CLE 为 命令 锁 存 ， 发 送 命令 时 需要 拉 
; ALE 为 地 址 /数据 锁 存 ，L/O[0~7] 为 8 根 数据 线 ， RnB 为 忙 信号 ; FREn 为 读 操作 有 效 信 
; FWEn 为 写 操作 有 效 信号 。 图 12-3 为 S3C6410X 的 Flash 接口 时 序 。 


TACLS TWRPHO TWRPHI 
| 1 1 1 


du zy 


'TWRPHO | TWRPHI i 


— ea 


I 1 1 
HCLK | | | 
| | l l HCLK 
1 1 1 
CLE/ALE| ! | \ ; | | i i 
1 1 
h nWE/nRE | \ " 
nWE | 1 1 1 1 
1 1 1 1 1 
1 
1 
1 
1 


图 12-3 S3C6410X 的 Flash 接口 时 序 


NAND Flash 的 操作 是 通过 命令 来 完成 的 ， 整 个 命令 包括 命令 、 地 址 、 数 据 几 个 部 分 。 
标准 的 NAND Flash 命令 如 下 : 


#define NAND CMD READO 0 
#define NAND CMD READ! 1 
#define NAND CMD RNDOUT 5 
#define NAND CMD PAGEPROG 0x10 
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#define NAND CMD READOOB 0x50 
#define NAND CMD ERASEI 0x60 
#define NAND CMD STATUS 0x70 
#define NAND _ CMD SEQIN 0x80 
#define NAND CMD RNDIN 0x85 
#define NAND CMD READID 0x90 
#define NAND CMD ERASE2 0xd0 
#define NAND CMD PARAM Oxec 
#define NAND CMD GET FEATURES 0xee 
#define NAND CMD SET FEATURES Oxef 
#define NAND CMD RESET Oxff 
#define NAND CMD LOCK 0x2a 
#define NAND CMD UNLOCKI 0x23 
#define NAND CMD UNLOCK2 0x24 


12.2.2 NAND 核心 层 架构 
NAND 核心 层 代 码 在 /drivers/mtd/nand 目录 。NAND wrr H nand chip 结构 表示 : 


struct nand chip { 
struct mtd info mtd; 
void  iomem *IO ADDR R;// 读 地 址 
void iomem *IO _ADDR W;// 写 地 址 
uint8 t (*read byte)(struct mtd info *mtd); 
ul6 (*read word)(struct mtd info *mtd); 


void (*write byte)(struct mtd info *mtd, uint8 t byte); 


void (*write buf)(struct mtd info *mtd, const uint8 t *buf, int len); 

void (*read buf)(struct mtd info *mtd, uint8 t *buf, int len); 

void (*select chip)(struct mtd info *mtd, int chip);//26 3-55 

int (*block bad)(struct mtd info *mtd, loff t ofs, int getchip); 

int (*block markbad)(struct mtd info *mtd, loff t ofs);// 标 记 坏 块 

void (*emd ctrl)(struct mtd. info *mtd, int dat, unsigned int ctr]);// 命 令 与 控制 实现 
int (*dev ready)(struct mtd info *mtd);/ 设 备 就 绪 

void (*cmdfunc)(struct mtd info *mtd, unsigned command, int column,int page addr);// 发 送 命令 
int(*waitfunc)(struct mtd info *mtd, struct nand chip *this);// 等 待 

int (*erase)(struct mtd. info *mtd, int page);// 擦 除 

int (*scan bbt)(struct mtd. info *mtd);// 扫 描 BBT 

int (*errstat)(struct mtd info *mtd, struct nand chip *this, int state,int status, int page); 


int (*write page)(struct mtd info *mtd, struct nand chip *chip, 
uint32 t offset, int data len, const uint8 t *buf, 
int oob required, int page, int cached, int raw); 

int (*onfi set features)(struct mtd info *mtd, struct nand chip *chip, 
int feature addr, uint8 t *subfeature para); 

int (*onfi get features)(struct mtd info *mtd, struct nand chip *chip, 
int feature addr, uint8 t *subfeature para); 

int (*setup read retry)(struct mtd info *mtd, int retry mode); 

int chip delay; 
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/OOB 与 ECC 相关 

uint8 t *oob poi; 

struct nand hw control *controller; 
struct nand ecc ctrl ecc; 

struct nand buffers *buffers; 

struct nand hw control hwcontrol; 
uint8 t *bbt;// 坏 块 表 

struct nand bbt descr *bbt td; 
struct nand bbt descr *bbt md; 
struct nand bbt descr *badblock pattern; 
void *priv; 


B 
nand set defaults 函数 用 来 设置 NAND Flash 芯片 的 默认 操作 函数 : 


static vold nand set defaults(struct nand chip *chip, int busw) 
1 
[BR GER 7g 200s*/ 
if (!chip->chip delay) 
chip-^chip delay = 20; 
if (chip-^cmdfunc — NULL) 
chip-^cmdfunc = nand command; 
if (chip->waitfunc — NULL) 
chip->waitfunc = nand wait; 
if (!chip-^select chip) 
chip->select chip — nand select chip; 
if (!chip->onfi set features) 
chip-^onfi set features = nand onfi set features; 
if (!chip-^onfi get features) 
chip->onfi get features = nand onfi get features; 
if (!chip-^read byte || chip-^read byte == nand read byte) 
chip-^read byte = busw ? nand read bytel6 : nand read byte; 
if (!chip->read word) 
chip-^read word = nand read word; 
if (!chip-2block bad) 
chip->block bad = nand block bad; 
if (!chip->block markbad) 
chip->block markbad = nand default block markbad; 
if (Ichip-7write buf || chip-7write buf == nand write buf) 
chip-write buf = busw ? nand write bufl6: nand write buf, 
if (!Ichip-7write byte || chip-7write byte == nand write byte) 
chip-^write byte = busw ? nand write bytel6:nand write byte; 
if (Ichip-^read buf || chip-^read buf == nand read buf) 
chip-^read buf- busw ? nand read bufl6: nand read buf, 
if (!chip-^scan bbt) 
chip-^scan bbt- nand default bbt; 


306 


第 12 章 NAND Flash 驱动 


if (!chip->controller) { 
chip->controller = &chip->hwcontrol; 
spin lock init(&chip->controller->lock); 
init waitqueue head(&chip-»controller-^wq); 


} 
默认 的 命令 发 送 函 数 为 nand_command: 


static void nand command(struct mtd info *mtd, unsigned int command,int column, int page addr) 
{ 

register struct nand chip *chip = mtd to nand(mtd); 

int ctrl = NAND CTRL CLE | NAND CTRL CHANGE; 

/ 先 发 送 命令 

if (command == NAND CMD SEQIN) (//NAND CMD SEQIN 命令 额外 处 理 


int readcmd; 


if (column >= mtd->writesize) { 
/*OOB 区 */ 
column -= mtd->writesize; 
readcmd = NAND CMD READOOB; 
} else if (column < 256) { 
/*First 256 bytes --> READO*/ 
readcmd = NAND CMD READO; 
} else ( 
column -= 256; 
readcmd - NAND CMD READI; 


j 
chip->cmd ctrl(mtd, readcmd, ctrl); 
ctrl &- -NAND CTRL CHANGE; 
j 
chip-^cmd ctrl(mtd, command, ctrl); 
/再 发 送 命令 地 址 
ctrl = NAND CTRL ALE|NAND CTRL CHANGE; 
if (column != -1) { 
[* J 16bit 线 宽 调整 列 */ 
if (chip->options & NAND BUSWIDTH 16 &&!nand opcode 8bits(command)) 


column >>= 1; 


chip-^cmd ctrl(mtd, column, ctrl); 
ctrl &- -NAND CTRL CHANGE; 
j 
if(page addr != -1) { 
chip->cmd ctrl(mtd, page addr, ctrl); 
ctrl &- -NAND CTRL CHANGE; 
chip->cmd ctrl(mtd, page addr >> 8, ctrl); 
EXAKT 32MB 的 设备 */ 
if (chip->chipsize > (32 << 20)) 
chip->cmd ctrl(mtd, page addr >> 16, ctrl); 


307 


Linux 驱动 程序 开发 实例 第 2 版 


CHANGE); 


j 


chip-»cmd ctrl(mtd, NAND CMD NONE, NAND NCE | NAND CTRL CHANGE); 


// Program 与 erase 命令 有 自己 的 busy 处 理 状 态 ， 无 需 延 迟 
switch (command) { 
case NAND CMD PAGEPROG: 
case NAND CMD ERASEI: 
case NAND CMD ERASE2: 
case NAND CMD SEQIN: 
case NAND CMD STATUS: 
return; 
case NAND CMD RESET: 
if (chip-»dev ready)break; 
udelay(chip-^chip delay); 


chip-»cmd ctrl(mtd, NAND CMD STATUS,NAND CTRL CLE|NAND CTRL 


chip-»cmd ctrl(mtd,NAND CMD NONE, NAND NCE | NAND CTRL CHANGE); 


[ABS ONFi v4.0， 等 待 250ms*/ 
nand wait status ready(mtd, 250); 
return; 
default: 
// 如 果 无 法 访问 BUSY 管 脚 ， 则 延迟 后 返回 
if (Ichip->dev_ready) { 
udelay(chip->chip_delay); 


return; 


} 
ndelay(100); 
nand_wait_ready(mtd);// 等 待 就 绪 


} 


F 面 为 默认 的 NAND Flash 读 写 接口 实现 : 


12.2.3 


NAND Flash 分 为 多 个 块 (block)， 块 又 包含 多 个 页 (page), fA E 


static vold nand write buf(struct mtd info *mtd, const uint8 t *buf, int len) 
1 

struct nand chip *chip — mtd to nand(mtd); 

iowrite8 rep(chip--IO ADDR W, buf, len);/ 连 续 的 IO 写 


j 


static void nand read buf(struct mtd info *mtd, uint8 t *buf, int len) 
1 

struct nand chip *chip = mtd to nand(mtd); 

ioread8 rep(chip--IO ADDR R, buf, len); /连续 的 IO i 


NAND Flash 坏 块 处 理 


B 


而 包含 数据 


及 OOB X. B| 12-4 为 K9F2G08X0A 的 存储 结构 。 
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以 


第 12 章 NAND Flash 驱动 


1 个 块 =64 页 
(128K+4K) 字 节 


1 个 页 =CK+64) 字 节 
1 个 块 =(2K+64)BX64 页 


128K 个 页 =(128K+4K) 字 节 
(=2.048 个 块 ) 1 个 设备 =(2K+64)BX64 页 X2.048 块 
=2.112Mbits 
8bit 
IO 0~1/07 


了 
2K 字 证 eA 


图 12-4 K9F2G08X0A 存储 结构 


OOB 区 《〈 带 外 区 ) 存放 一 些 特殊 数据 ， 最 重要 的 就 是 ECC (Error Checking and 
Correction) 数据 。ECC 用 来 检查 block 中 的 数据 是 否 正 确 ， 它 能 纠正 Ibit 的 数据 错误 ， 并 能 
检查 2bit 的 数据 错误 。 写 入 数据 时 ， 会 计算 每 个 写 入 块 的 ECC 值 ， 存 放 到 OOB 中 。 读 数据 
时 ， 会 对 读 到 的 数据 计算 出 ECC, 5 OOB 中 的 ECC 进行 对 比 。 假 如 超过 1bit 的 数据 出 
BO DW UE. PRESS Flash HH BBT (bad block table) 表 。Linux 内 核 启 
动 时 会 读 取 BBT 表 ， 后 面 的 NAND 操作 会 绕 过 BBT Hh. Sito BBT 扫描 ， 可 以 设置 
nand chip 结构 的 options 为 忽略 BBT 扫描: 


#define NAND SKIP BBTSCAN 0x00010000 
当然 ， 假 如 内 核 与 根 文件 系统 存储 区 出 现 坏 块 ， 可 能 会 导致 系统 无 法 启动 ， 通 常 需 要 重 
新 烧 写 才 可 。 所 以 很 多 嵌入 式 系统 会 将 内 核 与 文件 系统 镜像 备份 在 Flash. 的 某 个 分 区 ， 当 
统 出 现 问题 时 ， 可 以 进行 自动 修复 。ECC 相关 的 操作 结构 如 下 : 


TED 


struct nand ecc ctrl { 
nand ecc modes t mode; 
int steps;// 每 页 的 ECC step 数量 
int size;// 每 个 ECC step 的 字 节 数 
int bytes; /每 个 ECC step 的 ECC 字 节 
int total;// 每 页 总 的 ECC 字 节 
int strength;// 每 个 ECC step 纠正 的 最 大 bit 数 
int prepad; 


int postpad; 


unsigned int options;//ECC 标志 
struct nand ecclayout *layout;//ECC 布局 

void *priv; 

void (*hwcetl)(struct mtd info *mtd, int mode); 

int (*calculate)(struct mtd. info *mtd, const uint8 t *dat,uint8 t *ecc. code);/il $$ ECC 

int (*correct)(struct mtd info *mtd, uint8 t *dat, uint8 t *read ecc,uint8 t *calc ecc);/2l| IE 


int (*read page raw)(struct mtd info *mtd, struct nand chip *chip, 
uint8 t *buf, int oob required, int page); /无 校 验 读 页 

int (*write page raw)(struct mtd info *mtd, struct nand chip *chip, 
const uint8 t *buf, int oob required, int page); /无 校 验 写 页 
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js 


int (*read page)(struct mtd info *mtd, struct nand chip *chip, 

uint8 t *buf, int oob required, int page);// 读 页 
int (*read subpage)(struct mtd info *mtd, struct nand chip *chip, 

uint32 t offs, uint32 t len, uint8 t *buf, int page);// 读 子 页 
int (*write subpage)(struct mtd info *mtd, struct nand. chip *chip,/*5-T- Vi 

uint32 t offset, uint32 t data len,const uint8 t *data buf, int oob required, int page); 
int (*write page)(struct mtd info *mtd, struct nand chip *chip, 

const uint8 t *buf, int oob required, int page);// 写 页 
int (*write oob raw)(struct mtd info *mtd, struct nand. chip *chip,int page); /无 校 验 写 OOB 
int (*read oob raw)(struct mtd info *mtd, struct nand chip *chip,int page); /无 校 验 读 OOB 
int (*read oob)(struct mtd info *mtd, struct nand. chip *chip, int page);// 读 OOB 
int (*write oob)(struct mtd info *mtd, struct nand chip *chip,int page);// 写 OOB 


另外 


于 漂移 效应 、 编 程 干扰 、 读 干扰 ，Nand Flash 的 某 些 block 会 偶尔 出 现 bit 级 别 的 


值 翻转 ， 即 某 些 bit 由 1 变 为 0, 或 由 0 变 为 1， 这 种 现象 称 作 位 反 转 (bitflip)。 出 现 Ibit 的 


位 反 转 还 能 修复 ， 往 往 也 不 被 系统 当 作 坏 块 。 但 对 于 只 有 Ibit 的 位 反 转 ， 也 应 及 时 修复 ， 避 


Faiz block ! 


其 他 bit 继续 发 生 位 反 转 ， 造 成 不 可 修复 的 数据 错误 。 位 反 转 可 以 用 nanddump 


工具 检测 与 修复 : 


root@#nanddump  /dev/mtd5  -fa.txt -1 8388608 -o 


ECC: 1 corrected bitflip(s) at offset 0x0920b800( 这 里 为 位 反 转 提示 的 示例 ) 


12.3 S3C6410X NAND Flash 驱动 


本 驱动 例 程 中 ，S3C6410X 外 接 KOF2G08X0A 芯片 。 平 台 设 备 私 有 数据 中 包含 的 分 区 信 


息 定 义 如 下 : 


struct mtd partition s3c partition info[] = 1 
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1 
.name = "Bootloader", 
.offset = 0, 
„size =(256*SZ 1K), 
.mask flags — MTD CAP NANDFLASH, 
jc 
1 
.name — "Kernel", 
offset = (256*SZ 1K), 
„size =(4*SZ 1M) - 256*SZ 1K), 
.mask flags - MTD CAP NANDFLASH, 
Je 
{ 
.name = "Rootfs", 
.offset — (A*SZ 1M), 
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„size = (80*SZ_1M),//(48*SZ_1M), 
h 
1 
.name — "File System", 
offset = MTDPART OFS APPEND, 
„size = MTDPART SIZ FULL, 
} 


js 


struct s3c2410 nand sets3c nand mtd part info = { 


nr chips = 1, 
.nr partitions = ARRAY SIZE(s3c partition info), 


.partitions — s3c partition info, 


3 
struct flash platform data s3c_onenand data= { 
„parts —s3c partition info, 
nr parts = ARRAY SIZE(s3c partition info), 


5 
static struct resource s3c nand resource[] = { 
[0] = DEFINE RES MEM(S3C PA NAND, SZ 1M), 


} 
struct platform device s3c_device_nand = { 
.name = "S3c2410-nand", 
id =-], 
.num resources —ARRAY SIZE(s3c nand resource), 
resource — s3c nand resource, 
B 
static void — init smdk6410 machine init(void) 
1 


S3c device nand.name = "s3c6410-nand"; 
s3c device nand.dev.platform data — &s3c nand mtd part info; 


j 
平台 驱动 层 定义 如 下 : 


static struct platform driver s3c6410 nand driver - { 


.probe = $3c6410 nand probe, 
remove = s3c nand remove, 
Suspend = s3c nand suspend, 
resume = s3c nand resume, 
.driver ={ 


.name = "s3c6410-nand", 
.owner = THIS MODULE, 


h 
s3c6410 nand probe 函数 实际 上 调用 的 是 s3c_nand probe 函数 ， 后 者 主要 代码 如 下 : 
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static int S3c_nand probe(struct platform device *pdev, enum s3c cpu type cpu type) 
1 
struct s3c2410 nand set *plat info = pdev-^dev.platform data; 
struct mtd partition *partition info = (struct mtd partition *)plat info-^partitions; 
struct nand chip *nand; 


struct resource *res; 


int err — 0; 
int ret = 0; 
int 1, j, size; 


#if defined(CONFIG MTD NAND S3C HWECC) 
struct nand flash dev *type - NULL; 
u char tmp; 
#endif 
POUR BR FERES 
s3c nand.clk = clk get(&pdev-^dev, "nand"); 
if(IS ERR(s3c nand.clk)) { 
dev err(&pdev-»dev, "failed to get clock"); 
err= -ENOENT; 


goto exit error; 


j 
clk prepare enable(s3c nand.clk); 
res = pdev-"resource; 
size = res->end - res->start + 1; 
s3c_nand.area = request mem region(res-»start, size, pdev->name); 
if (s3c nand.area == NULL) { 
dev err(&pdev-»dev, "cannot reserve register region Wn"); 
err = -ENOENT; 


goto exit error; 


} 

s3c nand.cpu type = cpu type; 

s3c nand.device = &pdev-»dev; 

s3c nand.regs = joremap(res-»start, size);// 寄 存 器 映射 


if (s3c nand.regs == NULL) { 
dev err(&pdev-»dev, "cannot reserve register region Wn"); 
err — -EIO; 
goto exit error; 
j 
/* 2) R6 MTD 原始 设备 与 芯片 信息 */ 
s3c mtd = kmalloc(sizeof(struct mtd info) + sizeof(struct nand chip), GFP KERNEL); 
if(!s3c mtd) { 
printk("Unable to allocate NAND MTD dev structure. Wn"); 
return -ENOMEM; 


} 
nand = (struct nand chip *) (&s3c mtd[0]); 


memset((char *) s3c mtd, 0, sizeof(struct mtd info)); 
memset((char *) nand, 0, sizeof(struct nand chip)); 
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虚 根 据 分 区 信息 注册 MTD 设备 */ 

s3c_mtd->priv = nand; 

for (i = 0; i < plat info->nr chips; i++) { 
nand->IO ADDR R = (char *)(s3c nand.regs + S3C NFDATA); 
nand->IO ADDR W = (char *)(s3c nand.regs + S3C_NFDATA); 


nand->cmd ctrl —s3c nand hwcontrol; 
nand--dev ready = s3c nand device ready; 
nand-^scan bbt = s3c nand scan bbt; 
nand--options -0; 

#if defined(CONFIG MTD NAND S3C HWECC)// 如 果 定 义 了 人 硬件 ECC 
nand->ecc.mode = NAND ECC HW; 
nand--ecc.hwetl = s3c nand enable hwecc; 
nand--ecc.calculate = s3c nand calculate ecc; 
nand--ecc.correct = s3c nand correct data; 


s3c nand hwcontrol(0NNAND CMD READID,NAND NCEINAND CLE| 
NAND CTRL CHANGE); 
s3c nand hwcontrol(0, 0x00, NAND CTRL CHANGE | NAND NCE|NAND ALE); 
s3c nand hwcontrol(0, 0x00, NAND NCE | NAND ALB); 
s3c nand hwcontrol(0, NAND CMD NONE, NAND NCE|NAND CTRL CHANGE); 
s3c nand device ready(0); 
tmp = readb(nand--IO ADDR RJ); /#* 制 造 商 ID*/ 
tmp = readb(nand--IO ADDR R); /* 4& ID*/ 
for (j = 0; nand flash ids[j].name != NULL; j+) { 
if (tmp == nand flash ids[j].dev 1d) { 
type = &nand flash ids[j]; 


break; 

j 
j 
if (!type) 1 

printk("Unknown NAND Device. n"); 

goto exit error; 
j 
nand-»bits per cell = readb(nand--IO. ADDR R); 。 /* 第 3 字 节 */ 
tmp = readb(nand-^IO ADDR R); /# 第 4 字 节 #/ 


if (!type-^pagesize) { 
if (((nand-»bits per cell >> 2) & 0x3) = 0) ( 

nand type - S3C NAND TYPE SLC; 

nand--ecc.size = 512; 

nand--ecc.bytes —-4; 

if (1024 << (tmp & 0x3)) > 512) 1 
nand-^ecc.read page = s3c_nand read page lbit; 
nand-^ecc.write page —s3c nand write page lbit; 
nand--ecc.read oob = s3c nand read oob Ibit; 
nand--ecc.write oob = s3c nand write oob 1bit; 
nand--ecc.layout = &s3c nand oob 64; 

) else ( 
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nand->ecc.layout = &s3c nand oob 16; 
j 
} else ( 
nand type - S3C NAND TYPE MLC; 
nand-»options = NAND NO SUBPAGE WRITE; ”/* 不 支持 子 页 写 */ 
nand->ecc.read page = s3c nand read page 4bit; 
nand->ecc.write page —s3c nand write page 4bit; 
nand--ecc.size = 512; 
nand--ecc.bytes = 8; 
nand--ecc.layout = &s3c nand oob mle 64; 


j 
j 
#else 
nand->ecc.mode = NAND ECC SOFT:/ 软 件 ECC 模式 
#endif 
if (nand scan(s3c mtd, 1)) {// 扫 描 nand 
ret = -ENXIO; 
goto exit_error; 
j 
大 注册 分 区 ， 添 加 设备 六 
add mtd partitions(s3c mtd, partition info, plat info-^nr partitions); 
} 
pr debug("initialized ok\n"); 
return 0; 
exit error: 
kfree(s3c mtd); 
return ret; 
j 


s3c nand probe 函数 调用 了 nand scan 函数 ，nand scan 函数 后 面 调用 了 nand set_ 
defaults 函数 ， 这 样 大 部 分 NAND 操作 基本 上 使 用 通用 的 处 理 函 数 。s3c_nand_hwcontrol P 
数 是 硬件 相关 的 控制 接口 ， 可 用 于 发 送 命令 与 地 址 以 及 控制 硬件 管 脚 : 


static void s3c nand hwcontrol(struct mtd info *mtd, int dat, unsigned int ctrl) 


1 


pal 


unsigned int cur; 
void  iomem *regs = s3c nand.regs; 
if (ctrl & NAND CTRL CHANGE) ( 
if (ctrl & NAND NCE) { 
if (dat != NAND CMD NONE) ( 
cur = readl(regs + S3C NFCONT); 
cur &= ~S3C NFCONT nFCEO0; 
writel(cur, regs + S3C NFCONT); 
} 
} else { 
cur= readl(regs + S3C NFCONT); 
cur |= S3C_NFCONT nFCE0; 
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writel(cur, regs + SAC NFCONT); 


j 
if(dat!- NAND CMD NONE) { 
if (ctl & NAND CLE) 
writeb(dat, regs - S3C NFCMMD); 
else if (ctl & NAND ALE) 
writeb(dat, regs - S3C NFADDR); 


j 


下 面 是 S3C6410X NAND Flash 芯片 操作 命令 实例 ， 


[root@urbetter /homel# ./flash erase /dev/mtd3 0 1376 

Erasing 128 Kibyte (a) abe0000 -- 100 % complete 

[root(Qurbetter /homel# rm b.txt 

[root(Qurbetter /home]? — /nandwrite -p /dev/mtd3 a.txt 

Writing data to block 0 at offset 0x0 

[root@urbetter /home] .nanddump  /dev/mtd3  -fb.txt -1 2000 
ECC failed: 0 

ECC corrected: 0 

Number of bad blocks: 0 

Number of bbt blocks: 0 

Block size 131072, page size 2048, OOB size 64 

Dumping data starting at 0x00000000 and ending at 0x00000740... 
[root(Qurbetter /home]£ cat b.txt 
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1234567890111111111111111111222222222222222222222222222222333333333333333333333333333 
3333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333 
3333333333 


12.4 Ubifs 文件 系统 实例 


Ubifs 3f 


、 格 式 化 、 加 载 等 步骤 : 


[root@urbetter /homel# ./flash erase /dev/mtd3 0 1376 
Erasing 128 Kibyte (a) abe0000 -- 100 % complete 
[root(Q)urbetter /home | /ubiattach /dev/ubi ctrl -m 3 -d 0 
ubi0: attaching mtd3 

ubi0: scanning is finished 

ubi0: empty MTD device detected 

ubi0: attached mtd3 (name "File System", size 172 MiB) 
ubi0: PEB size: 131072 bytes (128 KiB), LEB size: 129024 bytes 
ubi0: min./max. I/O unit sizes: 2048/2048, sub-page size 512 
ubi0: VID header offset: 512 (aligned 512), data offset: 2048 
ubi0: good PEBs: 1376, bad PEBs: 0, corrupted PEBs: 0 


F 系 统 通 常 被 看 成 jffs2 文件 系统 的 升级 版 本 。 第 一 次 建立 Ubifs 文件 系统 包括 
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ubi0: user volume: 0, internal volumes: 1, max. volumes count: 128 

ubi0: max/mean erase counter: 0/0, WL threshold: 4096, image sequence number: 3295973323 

ubi0: available PEBs: 1332, total reserved PEBs: 44, PEBs reserved for bad PEB handling: 40 

ubi0: background thread "ubi bgtOd" started, PID 1187 

UBI device number 0, total 1376 LEBs (177537024 bytes, 169.3 MIB), available 1332 LEBs (171859968 


bytes, 163.9 MiB), LEB size 129024 bytes (126.0 KiB) 


name "root 


LEBs) 


[root@urbetter /homel# ./ubimkvol /dev/ubi0 -n 0 -N rootfs0 -s 78MiB 

Volume ID 0, size 634 LEBs (81801216 bytes, 78.0 MiB), LEB size 129024 bytes (126.0 KiB), dynamic, 
fs0", alignment 1 

[root(Q)urbetter /home|# df 

Filesystem 1K-blocks Used Available Use?o Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 

29799484 10715960 17546756 3896/ 

tmpfs 61944 0 61944 0% /dev/shm 

[root(a)urbetter /homel# ./mount -t ubifs ubi0 0 /mnt/disk 

-/bin/sh: ./mount: not found 

[root(Q)urbetter /home |? mount -t ubifs ubi0 0 /mnt/disk 
UBIFS (ubi0:0): default file-system created 
UBIFS (ubi0:0): background thread "ubifs bgtO 0" started, PID 1194 
UBIFS (ubi0:0): UBIFS: mounted UBI device 0, volume 0, name "rootfs0" 
UBIFS (ubi0:0): LEB size: 129024 bytes (126 KiB), min./max. I/O unit sizes: 2048 bytes/2048 bytes 
UBIFS (ubi0:0): FS size: 80510976 bytes (76 MiB, 624 LEBS), journal size 3999744 bytes (3 MiB, 31 


UBIFS (ubi0:0): reserved for root: 3802731 bytes (3713 KiB) 
UBIFS (ubi0:0): media format: w4/r0 (latest is w4/r0), UUID  4470747F-2824-47E7-81E5- 


D7B6E64E8AAD, small LPT model 


UBIFS (ubi0:0): full atime support is enabled. 
[root(Qurbetter /home]* df 
Filesystem 1 K-blocks Used Available Use% Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 

29799484 10715960 17546756 38%/ 
tmpfs 61944 0 61944 . 096 /dev/shm 
ubi0 0 73236 16 69504 0% /mnt/disk 


之 后 创建 一 个 文件 。 


[root@urbetter disk]? echo aaa >aaa 
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单一 个 Ubifs 文件 系统 就 建立 成 功 了 。 重 启 Linux 后 ， 无 需 再 格式 化 ， 可 以 直接 


[root(Qurbetter /home]ļ#./ubiattach /dev/ubi ctrl -m 3 -d 0 

ubi0: scanning is finished 

ubi0: attached mtd3 (name "File System", size 172 MiB) 

ubi0: PEB size: 131072 bytes (128 KiB), LEB size: 129024 bytes 
ubi0: min./max. I/O unit sizes: 2048/2048, sub-page size 512 
ubi0: VID header offset: 512 (aligned 512), data offset: 2048 
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ubi0: good PEBs: 1376, bad PEBs: 0, corrupted PEBs: 0 

ubi0: user volume: 1, internal volumes: 1, max. volumes count: 128 

ubi0: max/mean erase counter: 2/1, WL threshold: 4096, image sequence number: 3295973323 

ubi0: available PEBs: 698, total reserved PEBs: 678, PEBs reserved for bad PEB handling: 40 

ubi0: background thread "ubi bgtOd" started, PID 1178 

UBI device number 0, total 1376 LEBs (177537024 bytes, 169.3 MiB), available 698 LEBs (90058752 


bytes, 85.9 MiB), LEB size 129024 bytes (126.0 KiB) 


LEBs) 


[root(Q)urbetter /home |? mount -t ubifs ubi0 0 /mnt/disk 

BIFS (ubi0:0): background thread "ubifs bgtO 0" started, PID 1183 

JBIFS (ub10:0): UBIFS: mounted UBI device 0, volume 0, name "rootfs0" 

BIFS (ubi0:0): LEB size: 129024 bytes (126 KiB), min./max. I/O unit sizes: 2048 bytes/2048 bytes 


U 
U 
U 
UBIFS (ubi0:0): FS size: 80510976 bytes (76 MiB, 624 LEBs), journal size 3999744 bytes (3 MiB, 31 


© 


BIFS (ubi0:0): reserved for root: 3802731 bytes (3713 KiB) 
UBIFS (ubi0:0): media format: w4r0 (latest is w4/r0), UUID 4470747F-2824-47E7-81E5- 


D7B6E64E8AAD, small LPT model 


建立 ubi 的 另 一 个 方式 是 先 制作 文件 系统 镜像 ， 然 后 烧 写 到 NAND Flash 4P, X 


UBIFS (Cubi0:0): full atime support is enabled. 
[root(Qurbetter /home]* df 
Filesystem 1 K-blocks Used Available Use% Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 
29799484 10715960 17546756 3896/ 
tmpfs 61944 0 61944 0% /dev/shm 
ubiO 0 73236 24 69500 0% /mnt/disk 
[root(Q)urbetter /home | cd /mnt/disk 
[root(Q)urbetter disk]? Is 
aaa 
[root@urbetter disk] cat aaa 
aaa 


4 


体 步 骤 如 下 : 


[root(Qurbetter /homel# ./mkfs.ubifs -r targetfs/ -o ubifs.img -m 2048 -e 129024 
-c 1580 
[root(Qjurbetter /home|# ./ubinize -o ubi.img -m 2048 -p 128KiB -s 512 -O 512 ubin 
ize.cfg 
[root @urbetter /homel# ./flash erase /dev/mtd3 0 1376 
Erasing 128 Kibyte (a) abe0000 -- 100 % complete 
[root(Qurbetter /home]# ./ubiformat /dev/mtd3 -f ./ubi.img 
ubiformat: mtd3 (nand), size 180355072 bytes (172.0 MiB), 1376 eraseblocks of 131072 bytes (128.0 


KiB), min. I/O size 2048 bytes 


libscan: scanning eraseblock 1375 -- 100 % complete 
ubiformat: 1376 eraseblocks are supposedly empty 
ubiformat: flashing eraseblock 15 -- 100 % complete 
ubiformat: formatting eraseblock 1375 -- 100 % complete 
[root(Q)urbetter /home |? ./ubiattach /dev/ubi ctrl -m 3 -d 0 
ubi0: attaching mtd3 
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ubi0: scanning is finished 

ubi0: volume 0 ("appfs") re-sized from 634 to 1332 LEBs 

ubi0: attached mtd3 (name "File System", size 172 MiB) 

ubi0: PEB size: 131072 bytes (128 KiB), LEB size: 129024 bytes 

ubi0: min./max. I/O unit sizes: 2048/2048, sub-page size 512 

ubi0: VID header offset: 512 (aligned 512), data offset: 2048 

ubi0: good PEBs: 1376, bad PEBs: 0, corrupted PEBs: 0 

ubi0: user volume: 1, internal volumes: 1, max. volumes count: 128 

ubi0: max/mean erase counter: 0/0, WL threshold: 4096, image sequence number: 1843408412 
ubi0: available PEBs: 0, total reserved PEBs: 1376, PEBs reserved for bad PEB handling: 40 
ubi0: background thread "ubi bgtOd" started, PID 1186 

UBI device number 0, total 1376 LEBs (177537024 bytes, 169.3 MiB), available 0 LEBs (0 bytes), LEB 


size 129024 bytes (126.0 KiB) 


71 LEBs) 


[root @urbetter /home ] mount -t ubifs ubiO0 0 /mnt/disk 

BIFS (ubi0:0): background thread "ubifs bgtO 0" started, PID 1190 

JBIFS (ubi0:0): UBIFS: mounted UBI device 0, volume 0, name "appfs" 

BIFS (ubi0:0): LEB size: 129024 bytes (126 KiB), min./max. I/O unit sizes: 2048 bytes/2048 bytes 
BIFS (ubi0:0): FS size: 170440704 bytes (162 MiB, 1321 LEBs), journal size 9033728 bytes (8 MiB, 


(ee emi eben 


UBIFS (ubi0:0): reserved for root: 0 bytes (0 KiB) 
UBIFS (ubi0:0) media format: w4/r0 (latest is w4/r0), UUID 9EBII13ES-F121-4BB0-85E8- 


2836CA1F59FS8, small LPT model 


UBIFS (ubi0:0): full atime support is enabled. 
[root(Qurbetter /home]* df 
Filesystem 1K-blocks Used Available Use?o Mounted on 
192.168.10.102:/root/fgj/nfs/rootfs 

29799484 10721380 17541336 38%/ 
tmpfs 61944 0 61944 0% /dev/shm 
ubi0 0 155836 16 155820 0% /mnt/disk 
[root(a)urbetter /home | cd /mnt/disk 
[root(a)urbetter disk]? ls 
atxt b.txt 
[root@urbetter disk] cat a.txt 
1234567890111111111111111111222222222222222222222222222222333333333333333333333333333 


3333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333 
3333333333 
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网 络 设备 红 动 程序 


网 络 设备 驱动 程序 是 Linux 内 核 中 第 三 大 类 设备 驱动 程序 。Linux 操作 系统 的 网 络 通信 


功能 非常 强大 ， 它 支持 TCP/IP, IPX, X.25, AppleTalk 等 网 络 协议 。 网 络 设备 驱动 程序 为 


13.1 


网 络 协议 子 系统 提供 了 硬件 支持 。 本 章 介 绍 网 络 设备 村 
训 开 发 技术 和 Linux 内 核 中 的 Netlink 机 制 。 


网 络 设 备 程序 概述 


13.1.1 网 络 设备 的 特殊 性 
网 络 设备 作为 Linux 的 三 类 设备 之 一 ， 有 非常 特殊 的 地 方 。 每 一 个 字符 设备 或 块 设备 都 


对 应 着 文件 系统 ， 


区 动 原理 、DM9000 网 卡 芯片 的 驱动 程 


的 一 个 文件 节点 如 /dev/hdal、/dev/sdal、/dev/ttyl 等 。 网 


络 设备 与 它们 不 


同 ， 所 有 网 络 设备 都 抽象 为 一 个 接口 ， 这 个 接口 提供 了 对 所 有 网 络 设备 的 操作 集合 。 网 络 接 


口 不 存在 于 Linux 的 文件 系统 中 ， 在 /dev 目录 下 没有 对 应 的 设备 名 ， 但 每 个 网 络 设备 有 自己 


的 设备 名 称 ， 从 设备 名 称 可 以 看 出 设备 类 型 ， 如 lo 表示 回环 设备 ，eth 表示 以 太 网 设备 。 同 
类 型 的 多 个 设备 从 0 向 上 编号 ， 如 以 大 网 设备 的 编号 为 eth0、ethl…ethn 等 。 使 用 ifconfig 
命令 可 以 查看 当前 活动 的 网 卡 信息 。 


与 应 


[root@urbetter home]# ifconfig 


eth0 


lo 


Link encap:Ethernet HWaddr 00:E0:A3:A4:98:67 
inetaddr:192.168.0.103 — Bcast:192.168.0.255  Mask:255.255.255.0 
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 
RX packets:4798 errors:0 dropped:0 overruns:0 frame:0 
TX packets:1542 errors:0 dropped:0 overruns:0 carrier: 
collisions:0 txqueuelen:1000 
RX bytes:3867512 (3.6 MiB) TX bytes:237974 (232.3 KiB) 
Interrupt:108 Base address:0x300 
Link encap:Local Loopback 
inet addr:127.0.0.1  Mask:255.0.0.0 
UP LOOPBACK RUNNING MTU:65536 Metric:1 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen: 1 
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B) 


Linux 操作 系统 下 ， 应 用 层 通过 Socket 机 制 与 网 络 协议 层 交 互 。Socket 


就 是 网 络 协议 层 


用 层 的 桥梁 ， 它 将 复杂 网 络 协议 隐藏 起 来 ， 为 应 用 层 提 供 了 一 个 简单 而 统一 的 接口 。 常 
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的 Socket 接口 类 型 有 两 种 : 流 式 Socket (SOCK STREAMO ) 和 数据 报 式 Socket 
SOCK DGRAM)。 流 式 Socket 是 一 种 面向 连接 的 Socket， 针 对 面向 连接 的 TCP 服务 应 
J; 数据 报 式 Socket 是 一 种 无 连接 的 Socket， 对 应 于 无 连接 的 UDP 服务 应 用 。 


一 


13.1.2 sk buff 结构 


sk_buff 结构 是 整个 Linux 内 核 网 络 子 系统 中 最 核心 的 数据 结构 。Linux 网 络 子 系统 中 的 
各 层 之 间 的 数据 传送 都 是 通过 sk_bu 企 结构 实现 的 。sk_bu 任 结构 定义 如 下 : 


struct sk buff { 


union { 
struct { 
此 这 两 个 成 员 必 须 放 在 首位 */ 
struct sk buff *next; 
struct sk buff *prev; 
union { 
ktime t tstamp; 
struct skb mstamp skb mstamp; 
h 
h 
struct rb node rbnode;/* 用 于 netem & tcp 栈 */ 
h 
struct sock *sk;// E 
struct net device *dev;// 对 应 的 网 络 设备 
char cb[48] _aligned(8):/ 探 制 缓冲 
unsigned long  Skb refdst; 
void (*destructor)(struct sk buff *skb); 
unsigned int len,data_len;// 数 据 区 总 长 度 以 及 非 线 性 数据 长 度 
. ul6 mac len,hdr len; 
kmemcheck bitfield begin(flags1); 
. ul6 queue mapping; 
. u8 cloned:1,nohdr:1,fclone:2,peeked:l,head frag:l,xmit more:1; 
kmemcheck bitfield end(flags1); 
. u32 headers start[0]; 
庶 私 有 成 员 */ 
. u32 headers end[0]; 
PESE UAI 
诺 下 面 的 成 员 放 在 末尾 ， 参 见 alloc_skb0 函 数 */ 
sk buff data t tail; 
sk buff data t end; 
unsigned char *head,*data; 
unsigned int truesize;// 真 实 大 小 ， 包 括 本 结构 与 数据 的 大 小 
atomic t users;// 引 用 计数 
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13.1.3 网络 设备 驱动 程序 架构 
网 络 设备 被 抽象 为 统一 的 接口 供 系 统 访问 ， 应 用 层 对 各 种 网 络 设备 的 访问 都 采用 统一 的 

形式 ， 也 就 是 套 接 字 形式 ， 它 具有 硬件 无 关 性 。 

网 络 设 备 驱 动 程序 最 重要 的 结构 是 net _ device。 该 结构 保存 一 个 网 络 接口 的 重要 信 


息 ， 是 网 络 驱 动 程序 的 核心 。net device 结构 非常 庞大 ， 下 面 介 绍 该 结构 中 几 个 最 重要 的 


struct net device { 
char name[IFNAMSIZ]; 
struct hlist node name hlist; 
char *ifalias; 
unsigned long mem end;/ 内 存 结束 


unsigned long 
unsigned long 


mem start; /内 存 开始 
base addr;// 基 地 址 


int irq;// F Wr 
atomic t carrier changes; 
unsigned long state; 

struct list head dev list; 

struct list head napi list; 

struct list head unreg list; 
struct list head close list; 

struct list head ptype all; 


struct list head 


netdev features t 
netdev features t 
netdev features t 
netdev features t 


ptype specific; 


features; 
hw_features;// 人 硬件 特性 
wanted features; 


vlan features; 


netdev features t 


hw enc features; 


netdev features t 


mpls features; 


int ifindex; 

int group; 

struct net device stats stats; 
atomic long t IX dropped; 
atomic long t tx dropped; 


#ifdef CONFIG WIRELESS EXT 
const struct iw handler def * wireless handlers; 
struct iw public data * 
#endif 
const struct net device ops *netdev_ops;// 网 络 设备 操作 
const struct ethtool ops *ethtool ops;//ethool 接口 


wireless data; 


js 
网 络 设备 注册 和 注销 函数 原型 如 下 : 
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intregister netdev(struct net device *dev); 
void unregister netdev(struct net device *dev); 


网 络 设备 操作 结构 net device ops 是 网 络 子 系统 提供 给 网 络 设备 驱动 的 接口 。 


struct net device ops { 


int (*ndo init)(struct net_device *dev); 

void (*ndo uninit)(struct net device *dev); 

int (*ndo open)(struct net device *dev); 

int (*ndo stop)(struct net device *dev); 

netdev tx t (*ndo start xmit)(struct sk buff *skb,struct net device *dev); 


netdev features t ^ (*ndo features check)(struct sk buff *skb,struct net device *dev, 
netdev features t features); 

ul6 (*ndo select queue)(struct net device *dev,struct sk buff *skb, 
void *accel priv,select queue fallback t fallback); 


void (*ndo change rx flags)(struct net device *dev,int flags); 

void (*ndo set rx mode)(struct net device *dev); 

int (*ndo set mac address)(struct net device *dev,void *addr); 

int (*ndo validate addr)(struct net device *dev); 

int (*ndo do ioctl)(struct net device *dev;struct ifreq *ifr, int cmd); 
int (*ndo set config)(struct net device *dev,struct ifmap *map); 

int (*ndo change mtu)(struct net device *dev,int new mtu); 

int (*ndo neigh setup)(struct net device *dev,struct neigh parms *); 
void (*ndo tx timeout) (struct net device *dev); 


struct rtnl link stats64* (*ndo get stats64)(struct net device *dev;struct rtnl link stats64 *storage); 
struct net device stats* (*ndo get stats)(struct net device *dev); 

int (*ndo vlan rx add vid)(struct net device *dev, bel6 proto, u16 vid); 
int (*ndo vlan rx kill vid)(struct net device *dev, bel6 proto, u16 vid); 


js 
网 络 设 备 驱 动 程序 与 网 络 子 系统 直接 交互 。 两 者 交互 的 基本 单位 是 sk buff 结构 。 
13-1 为 网 络 数 据 的 流 问 图 。 


应 用 层 套 接 字 (socket) 


网 络 子 系统 
网 络 协议 栈 


"S 


y 


网 络 设备 驱动 
MACIERZ) PHY 驱 动 


图 13-1 网 络 数 据 的 流向 
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网 络 子 系统 向 设备 驱动 下 发 数据 要 通过 dev queue xmit 函数 ， 而 dev queue xmit 函数 
会 调用 网 络 设备 的 netdev_ops ->ndo_start xmit 接口 。 


int dev queue xmit(struct sk buff *skb); 


网 络 设 备 收 到 数据 后 都 会 产生 一 个 中 断 。 在 中 断 处 理 程序 中 驱动 程序 会 申请 一 块 
sk_buff， 把 从 硬件 读 出 的 数据 放置 到 申请 好 的 缓冲 区 里 ， 接 下 来 填充 sk_buff 中 的 一 些 成 
员 ， 最 后 驱动 程序 调用 netif rx 函数 把 数据 传送 给 协议 层 。netif rx 函数 将 数据 放 入 处 理 队列 
后 返回 ， 真 正 的 处 理 是 在 中 断 返回 以 后 ， 这 样 可 以 减少 中 断 时 间 。 


int netif rx(struct sk buff *skb); 


网 络 设备 驱动 程序 主要 功能 是 实现 netdev ops 结构 中 的 函数 接口 。 
(1) ndo open 接口 


int  (*ndo open)(struct net device *dev); 
ndo open 接口 在 网 络 设备 被 激活 的 时 候 被 调用 。 它 主要 完成 资源 和 中 断 的 申请 以 及 
DMA 的 注册 等 工作 。 使 用 这 onfig 命令 可 以 激活 网 络 设备 。 
(2) ndo start xmit 接 


netdev tx t(*ndo start xmit)(struct sk buff *skb,struct net device *dev); 
ndo start xmit 接口 用 来 将 网 络 子 系统 发 来 的 数据 通过 网 卡 发 送 到 物理 网 络 。net_ device 


结构 中 没有 读数 据 接口 ， 读 数据 一 般 在 网 卡 中 断 中 处 理 。 
(3) ndo get stats 接 


H 


struct net device stats* (*ndo get stats)(struct net device *dev); 


ndo get stats 函数 返回 一 个 net device stats 结构 ， 该 结构 保存 了 驱动 所 管理 的 网 络 设备 
接口 的 详细 的 流量 与 错误 统计 信息 : 


T 


struct net device stats 

{ 
unsigned longrx. packets;/ 接 收 的 总 包 数 
unsigned longtx packets;// 发 送 的 总 包 数 
unsigned longrx bytes; /接收 总 字 节 数 
unsigned longtx bytes; /发 送 总 字 节 数 
unsigned longrx errors; // 收 到 的 错 包 数 量 
unsigned longtx errors; // 发 送 的 错 包 数量 
unsigned longrx_dropped;// 丢 弃 的 接收 包 数 量 
unsigned longtx dropped; // 丢 弃 的 发 送 包 数量 
unsigned longmulticast; /接收 的 多 播 包 数 
unsigned longcollisions; 
从 详细 的 接收 错误 统计 数据 头 
unsigned longrx_length_errors;// 长 度 错误 
unsigned longrx_over errors;// 环 行 缓冲 溢出 错误 
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二 


unsigned longrx crc errors; //CRC 校 验 错误 
unsigned longrx _ frame_errors:/ 帧 对 齐 错 误 
unsigned longrx fifo errors; /接收 缓冲 溢出 错误 
unsigned longrx_missed_errors;// 接 收 者 遗漏 错误 
上 详细 的 发 送 错误 统计 数据 闷 


unsigned longtx aborted errors; 


unsigned longtx carrier errors; 
unsigned longtx fifo errors; 
unsigned longtx heartbeat errors; 
unsigned longtx window errors; 
unsigned longrx compressed; 
unsigned longtx compressed; 


(4) ndo do ioctl 接口 


int 


Linux 下 有 一 些 特 定 的 socket ioctl, XE sockios.h 头 文件 中 。 网 络 子 系统 


(*ndo do ioctl)(struct net device *dev,struct ifreq *ifr, int cmd); 


RBAK 


现 了 这 些 IOCTL 命令 〈 见 /drivernetcore/dev ioctLc)， 也 有 的 命令 需要 在 自 定义 的 驱动 程序 


中 实现 。 常 用 的 IOCTL 命令 有 : 

define SIOCGIFMTU  0x8921 /# 获 取 MTU 大 小 */ 
#define SIOCSIFMTU  0x8922 [FEE MTU 大 小 */ 
#define SIOCSIFNAME  0x8923 PRE LT AA SI 
Zdefine SIOCSIFHWADDR  0x8924 PY ELCHE 
Zdefine SIOCGIFENCAP — 0x8925 FIRRA Je Te 
#define SIOCSIFENCAP — 0x8926 MEEA ERE e e 
Zdefine SIOCGIFHWADDR 0x8927 AIRE P TERRE 
#define SIOCADDMULTI 0x8931 诺 增 加 广播 地 址 */ 
#define SIOCDELMULTI 0x8932 yop) TERRE 
define SIOCGIFBRDADDR 0x8919 AIR HG 
#define SIOCSIFBRDADDR  0x891a 诺 设 置 广播 地 址 */ 

例 13.1 使 用 SIOCGIFHWADDR 获取 MAC 地 址 

本 例 介 绍 如 何 使 用 SIOCGIFHWADDR 获取 网 卡 MAC 地 址 。 参 考 代 码 如 下 : 


int fd; 
struct ifreq ifr; 


f = 


socket(AF INET SOCK DGRAM, 0); 


ifrifr addrsa family = AF INET; 
strncpy(ifr.ifr name, "eth0", IFNAMSIZ-1); 
ioctl(fd, SIOCGIFHWADDR, &ifr); 
close(fd); 
printf("96.2x:90.2x:90.2x:90.2x:90.2x:9/0.2x n", 
(unsigned char)ifr.ifr hwaddr.sa data[0], 
(unsigned char)ifr.ifr hwaddr.sa data[1], 
(unsigned char)ifr.ifr hwaddr.sa data[2], 
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(unsigned char)ifr.ifr hwaddr.sa data[3], 
(unsigned char)ifr.ifr hwaddr.sa data[4], 
(unsigned char)ifr.ifr hwaddr.sa data[5]); 


ndo do ioctl 函数 一 般 用 来 实现 驱动 程序 私有 的 IOCTL 命令 ， 命 令 的 类 型 在 
SIOCDEVPRIVATE 和 SIOCDEVPRIVATE+15 之 间 。 
(5) ndo set mac address 接口 


int 


uL 


(*ndo set mac address)(struct net device *dev,void *addr); 


该 接口 | 


来 设置 网 络 设备 的 MAC 地址 ，MAC 地 址 就 存放 在 addr 参数 中 。 


(6) ndo stop 接口 


int 


(*ndo stop)(struct net device *dev); 


ndo stop 接口 在 网 卡 状态 由 up 转 为 down 时 被 调用 ， 一 般 用 来 释放 资源 。 
13.1.4 ”虚拟 网 络 设备 驱动 程序 实例 


例 13.2 


虚拟 网 络 设备 驱动 程序 实例 


下 面 的 例子 为 一 个 虚拟 网 卡 驱动 程序 。 具 体 代码 见 \samples\13network\13-1net。 核 心 代 


码 如 下 : 


static char netbuffer[100]; 
struct net device *simnetdevs; 


void simnetrx(struct net device *dev, int len, unsigned char *buf) 


1 


j 


struct sk buff *skb; 
/分 配 sk. buff 
skb = dev alloc skb(len42); 
if (!skb) { 
printk("simnetrx can not allocate more memory to store the packet. drop the packet Wn"); 
dev-»stats.rx dropped; 
return; 
j 
skb reserve(skb, 2); 
memcpy(skb put(skb, len), buf, len); 
skb->dev = dev; 
skb->protocol = eth type trans(skb, dev); 
Pro BERI 
skb->ip summed = CHECKSUM UNNECESSARY,; 
dev->stats.TX_packets++;// 修 改 统计 数据 
netif rx(skb);// 向 上 层 提 交 数 据 


return; 


// 演 示 中 断 处 理 


static irqreturn t simnet interrupt (int irq, void *dev 1d) 


1 
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struct net device *dev; 

dev — (struct net device *) dev id; 
simnetrx(dev, 100,netbuffer); 
return IRO HANDLED; 


} 
int simnetopen(struct net_device *dev) 
{ 
int ret=0; 
printk("simnetopen"); 
/虚拟 中 断 
ret-request irq(IRQ_ NET CHIP, simnet interrupt, IROF _ SHARED,dev->name, dev); 
netif start queue(dev); 
return 0; 
} 
int simnetrelease(struct net device *dev) 
1 
printk("simnetrelease Wn"); 
netif stop queue(dev); 
return 0; 
} 
void simnethw tx(char *buf, int len, struct net device *dev) 
1 
放 检 查 包 的 完整 性 */ 
if (len < sizeof(struct ethhdr) + sizeof(struct iphdr)) 
1 
printk("Bad packet! It's size is less then 34! n"); 
return; 
} 
族 更 新 统计 数据 */ 
dev-»stats.tx packets; 
dev-»stats.rx bytes += len; 
} 
int simnettx(struct sk buff *skb, struct net device *dev) 
1 
int len; 
char *data; 
len = skb->len < ETH. ZLEN ? ETH ZLEN : skb--len; 
data = skb->data; 
PO i] TRIS 
dev-^trans start = jiffies; 
simnethw tx(data, len, dev); 
return 0; 
} 
void simnettx timeout (struct net device *dev) 
{ 


dev->stats.tx_errorstt; 
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netif wake queue(dev); 
return; 


j 


int simnetioctl(struct net device *dev, struct ifreq *rq, int cmd) 
1 

return 0; 
j 


struct net device stats *simnetstats(struct net device *dev) 


1 


return &dev-^stats; 


j 


int simnetchange mtu(struct net device *dev, int new mtu) 
1 

unsigned long flags; 

spinlock t *lock = &dev-^tx global lock; 

if(new mtu « 68) 

return -EINVAL; 

spin lock irqsave(lock, flags); 

dev-^mtu = new mtu; 

spin unlock irqrestore(lock, flags); 


return 0; 
j 
static const struct net device ops sim netdev ops = { 
.ndo open — simnetopen, 
ndo stop — simnetrelease, 
.ndo start xmit — simnettx, 
.ndo tx timeout — simnettx timeout, 
.ndo do ioctl — simnetioctl, 
.ndo change mtu = simnetchange mtu, 
.ndo get stats — simnetstats, 
h 
void simnetinit(struct net device *dev) 
{ 
ether setup(dev); 
dev->netdev_ ops — &sim netdev ops; 
dev->dev addr[0] = 0x18;//(0x01 & addr[0])7j multicast 
dev->dev addr[1] = 0x02; 
dev-^dev addr[2] = 0x03; 
dev->dev_ addr[3] = 0x04; 
dev->dev_ addr[4] = 0x05; 
dev->dev addr[5] = 0x06; 
EAA Es 
dev-^flags |= IFF NOARP; 
dev-^features |= NETIF F SG; 
spin lock init(&dev-^tx global lock); 
j 
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void simnetcleanup(void) 
1 
if (simnetdevs) 
1 
unregister netdev(simnetdevs); 
free netdev(simnetdevs); 
} 
return; 
} 
int simnetinit module(void) 
{ 
int result,ret --ENOMEM; 
PE SO A T en 
simnetdevs-alloc netdev(0, "eth?od" NET NAME UNKNOWN,simnetinit); 
if (simnetdevs == NULL) 
goto out; 
ret = -ENODEV; 
if (result = register netdev(simnetdevs)))// 注 册 网 络 设备 
printk("demo: error %i registering device \"%s\"\n", result, simnetdevs->name); 


else 
ret = 0; 
out: 
if (ret) 
simnetcleanup(); 
return ret; 
j 
module init(simnetinit module); 
module exit(simnetcleanup); 


这 个 驱动 没有 实际 作用 ， 仪 演示 如 何 开发 网 络 设备 驱动 。 运 和 


` 


m 


M 
ur 


ARU P: 


[root(Q)urbetter drivers | insmod demo.ko 

[root(a)urbetter drivers]? ifconfig eth1 192.168.1.23 

simnetopen 

[root@urbetter drivers]? ping 192.168.1.23 

PING 192.168.1.23 (192.168.1.23): 56 data bytes 

64 bytes from 192.168.1.23: seq-0 ttl=64 time-0.491 ms 

64 bytes from 192.168.1.23: seq-1 ttl=64 time-0.370 ms 

64 bytes from 192.168.1.23: seq-2 ttl=64 time-0.358 ms 

64 bytes from 192.168.1.23: seq-3 ttl=64 time-0.359 ms 

ABC 

--- 192.168.1.23 ping statistics --- 

4 packets transmitted, 4 packets received, 0% packet loss 

round-trip min/avg/max — 0.358/0.394/0.491 ms 

[root(a)urbetter drivers |? ifconfig eth1 

eth1 Link encap:Ethernet HWaddr 18:02:03:04:05:06 
inet addr:192.168.1.23 Bcast:192.168.1.255 Mask:255.255.255.0 
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UP BROADCAST RUNNING NOARP MULTICAST MTU:1500 Metric:l 
RX packets:0 errors:0 dropped:0 overruns:0 frame:0 
TX packets: errors:0 dropped:0 overruns:0 carrier:0 
collisions:0 txqueuelen:1000 
RX bytes:0(0.0 B) TX bytes:0 (0.0 B) 
[root(a)urbetter drivers] ifconfig ethl down 
simnetrelease 


13.4.5 ”网 络 硬件 接口 的 分 层 结构 


从 硬件 角度 看 ， 网 络 接 口 通常 包括 处 理 器 、MAC 层 、PHY 层 、 接 口 四 个 层次 ， 如 
13-2 所 示 。MAC 层 即 媒体 接 入 控制 器 ， 属 于 ISO 网 络 模型 的 数据 链 路 层 。PHY 层 为 物 
"HE MAC 层 与 PHY 层 之 间 的 接口 包括 MI RMI, GMI, RGMII 等 。MII 接口 与 PHY 


D 


寄存 器 均 有 国际 规范 ， 这 就 使 得 MAC 可 以 支持 几乎 任意 类 型 的 PHY 芯片 。 


处 理 器 | 内 存 接口 /内 部 总 线 MAC 层 PIIY 层 3 
RJ45 等 接口 


图 13-2 网 络 接口 的 层次 


有 的 处 理 器 没有 MAC 控制 器 ， 一 般 采 用 带 MAC 与 PHY 功能 的 集成 网 卡 芯片 实现 网 络 
收发 。 有 的 处 理 器 自 带 MAC 控制 器 ， 只 需要 添加 一 个 外 部 PHY 芯片 即 可 ， 如 图 13-3 5 


图 13-4 所 示 。 
MACH PY 
rmn RJ45 等 接口 


图 13-3 不 带 MAC 的 处 理 器 的 网 络 实现 


a | maca pu 世上 | 
RJ45 等 接口 


图 13-4 tf MAC 的 处 理 器 的 网 络 实现 


13.2. DM90004 网 卡 驱动 程序 开发 


13.2.1 DM9000A 原理 


DM9000A 是 一 款 高 度 集 成 的 单 芯 片 快 速 以 太 网 MAC 控制 器 ， 它 包含 一 个 通用 处 理 器 接 
口 、 一 个 10/100M PHY 和 一 个 4KB 大 小 的 双 字 节 SRAM。DM9000A 支持 IEEE 802.3x 全 双 工 
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制 。DM9000A 的 处 理 器 接口 用 来 连接 各 种 处 理 器 ， 它 的 寻 址 方式 有 两 种 : 一 种 是 

端口 ， 一 种 是 DATA 端口 。 当 管 脚 CMD 为 1， 当 前 访问 DATA 端口 ， 和 否则 访问 

端口 。INDEX 端口 的 内 容 就 是 DATA 端口 的 寄存 器 地 址 。DM9000A 集成 有 接收 缓冲 
区 ， 以 便 在 接收 到 数据 时 能 把 数据 放 到 这 个 缓冲 区 中 ， 然 后 由 数据 链 路 层 直接 从 该 缓冲 区 里 取 走 
数据 。DM9000A 还 提供 了 DMA 功能 ， 简 化 了 内 部 存储 器 的 访问 。DM9000A 的 主要 特性 如 下 : 


(1) 一 个 通 / 
(2) 集 

(GO 内 部 带 有 
(4) 

(5) 

(6) 


主机 接 
集成 10/100M 物理 层 (PHY) 


集成 了 EEPROM， 月 
一 个 MII 接口 ， 月 


EL 


于 连接 HPNA 设备 或 


H 


各 种 处 理 器 。 


接口 。 


16KB 的 SRAM， 用 作 接 收发 送 的 FIFO 缓存 。 
支持 8/16bit 两 种 主机 工作 模式 。 


昌 来 保存 初始 化 参数 ， 实 现 自 动 配置 。 


DM9000A 的 主要 寄存 器 见 表 13-1 一 表 13-6. 


表 13-1 网 络 控 融 


他 支持 MII 的 收发 器 。 


| 寄存 器 DM NCR (0x00) 


Bit 名 W 说 — Hj 
7 EXT PHY 1 选择 外 部 PHY, 0 选择 内 部 PHY， 不 受 软件 复位 影响 
6 WAKEEN 事件 唤醒 使 能 ，1 使 能 ，0 禁止 并 清除 事件 唤醒 状态 ， 不 受 软件 复位 影响 
5 保留 
4 FCOL 1 强制 冲突 模式 ， 用 于 用 户 测试 
3 FDX 全 双 工 模式 。 内 部 PHY 模式 下 只 读 ， 外 部 PHY 下 可 读 写 
da HE E 可 环 模式 (Loopback): 00 为 正常 模式 ，01 为 内 部 MAC 回环 模式 ，10 为 内 部 100M PHY 数字 回环 
模式 ，11 保留 
0 RST 1 软件 复位 ，10hs 后 自动 清 零 
d 13-2 网络 状态 寡 存 器 DM_NSR (0x01) 
Bit 名 称 说 明 
7 SPEED 媒介 速度 ， 在 内 部 PHY 模式 下 ，0 为 100Mbps，1 为 10Mbps。 当 LINKST=0 时 ， 此 位 不 
6 LINKST 连接 状态 ， 在 内 部 PHY 模式 下 ，0 为 连接 失败 ，1 为 已 连接 
5 WAKEST 唤醒 事件 状态 。 读 取 或 写 1 将 清 零 该 位 。 不 受 软件 复位 影响 
4 保留 
3 TX2END TX RIE) 数据 包 2 完成 标志 ， 读 取 或 写 1 将 清 零 该 位 。 数 据 包 指针 2 传输 完成 
2 TX2END TX RIE) 数据 包 1 完成 标志 ， 读 取 或 写 1 将 清 零 该 位 。 数 据 包 指针 1 传输 完成 
1 RXOV RX GZO) FIFO《〈 先 进 先 出 缓存 ) 溢出 标志 
0 保留 
表 13-3 发 送 控制 寄存 器 DM_TCR (0x02) 
Bit 名 HW 说 — Hj 
7 保留 
6 TJDIS Jabber 传输 使 能 。1 使 能 Jabber 传输 定时 器 (2048B) ，0 禁止 
5 EXCECM 额外 冲突 模式 控制 。0 当 额 外 的 冲突 计数 大 于 15 则 终止 本 次 数据 包 ，1 始终 尝试 发 送 本 次 数据 包 
4 PAD DIS2 禁止 为 数据 包 指 针 2 添加 PAD 
3 CRC DIS2 禁止 为 数据 包 指 针 2 添加 CRC 校 验 
2 PAD DISI 禁止 为 数据 包 指 针 1 添加 PAD 
1 CRC DISI 禁止 为 数据 包 指针 1 添加 CRC Fels 
0 TXREQ TX 发送) 请 求 。 发 送 完成 后 自动 清 零 该 位 


330 


第 13 章 网 络 设备 驱动 程序 


表 13-4 数据 包 指针 的 发 送 状 态 寡 存 器 1TSR_I (03H) 52TSR I (04H) 


Bit 名 称 说 — Hj 

7 TJTO Jabber 传输 超时 。 该 位 置 位 表示 由 于 多 于 2048B 数据 被 传输 而 导致 数据 帧 被 截 掉 

6 LC 载波 信号 丢失 。 该 位 置 位 表示 在 帧 传输 时 发 生 载 波 信号 丢失 。 在 内 部 回环 模式 下 该 位 无 效 
5 NC 无 载波 信号 。 该 位 置 位 表示 在 帧 传输 时 无 载波 信号 。 在 内 部 回环 模式 下 该 位 无 效 

4 LC 延迟 冲突 。 该 位 置 位 表示 在 64B 的 冲突 窗口 用 完 后 又 发 生 冲突 

3 COL 数据 包 冲 突 。 该 位 置 位 表示 传输 过 程 中 发 生 冲突 

2 EC 额外 冲突 。 该 位 置 位 表示 由 于 发 生 了 16 次 冲突 ( 即 额 外 冲突 ) 后 ， 传 送 被 终止 

1-0 保留 


表 13-5 接收 控制 寄存 器 RCR (05H) 


Bit 名 K 说 明 
7 保留 5 
6 WTDIS 看 门 狗 定 时 器 禁止 。1 禁止 ，0 使 能 
5 DIS LONG 丢弃 长 数据 包 。1 为 丢弃 数据 包 长 度 超过 1522B 的 数据 包 
4 DIS_CRC 丢弃 CRC 校 验 错误 的 数据 包 
3 ALL 忽略 所 有 多 点 传送 
2 RUNT 忽略 不 完整 的 数据 包 
1 PRMSC 混杂 模式 (Promiscuous Mode) 
0 RXEN 接收 使 能 


表 13-6 接收 状态 寡 存 器 RSR (06H) 


Bit 名 称 说 ” 明 

7 RF 不 完整 数据 帧 。 该 位 置 位 表示 接收 到 小 于 64B 的 帧 

6 MF 多 点 传送 帧 。 该 位 置 位 表示 接收 到 帧 包含 多 点 传送 地 址 

5 LCS 冲突 延迟 。 该 位 置 位 表示 在 帧 接收 过 程 中 发 生 冲突 延迟 

4 RWTO 接收 看 门 狗 定时 溢出 。 该 位 置 位 表示 接收 到 大 于 2048B 数据 帧 

3 PLE 物理 层 错 误 。 该 位 置 位 表示 在 帧 接收 过 程 中 发 生物 理 层 错误 

2 AE 对 齐 错误 〈Alignment)。 该 位 置 位 表示 接收 到 的 帧 结尾 处 不 是 字 节 对 齐 ， 即 不 是 以 字 节 为 边界 对 齐 
1 CE CRC 校 验 错 误 。 该 位 置 位 表示 接收 到 的 帧 CRC 校 验 错误 

0 FOE 接收 FIFO 缓存 溢出 。 该 位 置 位 表示 在 帧 接收 时 发 生 FIFO 溢出 


13.2.2 DM9000A 驱动 程序 分 析 


S3C6410X 没有 专门 的 MAC 控制 器 ， 通 过 SROM 控制 器 访问 DM9000A -REA o 
13-5 是 DM9000A 与 S3C6410X 的 电路 原理 


h 


DS 


o 


u 


SD15—SDO 
RST 
CMD 


S3C6410X IOW DM9000A 
IOR 
AEN 
INT 


图 13-5 DM9000A 5 S3C6410X 的 电路 原理 
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本 节 通 过 分 析 Linux 内 核 中 的 DM9000A 驱动 程序 来 介绍 网 络 设 备 驱动 程序 的 基本 
流程 。 首 先 定义 并 注册 平台 设备 : 


static struct platform driver dm9000 driver= { 
.driver ={ 
.name = "dm9000", 
.owner = THIS MODULE, 


.pm — &dm9000 drv pm ops, 
j » 
.probe = dm9000 probe, 
remove =  devexit p(dm9000 drv remove), 
h 
static int — init dm9000 init(void) 
1 
printk(KERN INFO "%s Ethernet Driver, V%s\n", CARDNAME, DRV VERSION); 
return platform driver register(&dm9000 driver); 
} 


在 设备 的 检测 函数 dm9000_probe 中 主要 完成 网 络 设备 初始 化 ， 并 获取 网 络 设备 的 平台 


资源 信息 ， 根 据 这 些 信息 申请 中 断 、 
对 DM9000 的 版 本 进行 识别 ， 并 i 
DM9000 网 络 设备 驱动 。dm9000_probe 代码 如 下 : 


static int dm9000 probe(struct platform device *pdev) 

{ 
struct dm9000 plat data *pdata = dev_get_platdata(&pdev->dev); 
struct board. info *db;/* 板 级 信息 */ 
struct net device *ndev; 
struct device *dev = &pdev-^dev; 


const unsigned char *mac src; 


int ret = 0; 
int losize; 
int i; 
u32 id. val; 
int reset gplos; 
enum of gpio flags flags; 
struct regulator *power; 
power = devm regulator get(dev, "vcc");/2X HX HB) Ui] 15 A 
if(IS ERR(power)) { 
if (PTR ERR(power) — -EPROBE DEFER) 
return -EPROBE DEFER; 
dev dbg(dev, "no regulator provided"); 


E 


yelse 1 
ret = regulator enable(power); 
if (ret != 0) ( 


dev err(dev,"Failed to enable power regulator: %d\n", ret); 
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return ret; 
} 
dev dbg(dev, "regulator enabled\n"); 
j 
/通过 GPIO 复位 芯片 


网 络 设备 驱动 程序 


reset gpios = of get named gpio flags(dev->of node, "reset-gpios", 0,&flags); 


if(gpio is valid(reset gpios)) { 


ret = devm gpio request one(dev, reset gpios, flags,"dm9000 reset"); 


if (ret) { 


dev err(dev, "failed to request reset gpio Vod: %d\n",reset gpios, ret); 


return -ENODEV; 


j 
msleep (2) ; 
gpio set value(reset gpios, 1); 
msleep (4) ; 
j 
if (!pdata) { 
pdata = dm9000 parse dt(&pdev--dev); 
if (IS ERR(pdata)) 
return PTR ERR(pdata); 
j 
PE) SO A T en 
ndev = alloc etherdev(sizeof(struct board. info));/ 会 额外 分 配 board info 结构 大 小 的 内 存 
if (Indev) 


return -ENOMEM; 
SET NETDEV DEV(ndev, &pdev->dev); 
dev dbg(&pdev-^dev, "dm9000 probe()n"); 
PATIR ESI 
db = netdev priv(ndev); 
db->dev = &pdev-^dev; 
db->ndev = ndev; 
spin lock init(&db->lock); 
mutex init(&db--addr lock); 
/初始 化 延 时 工作 队列 ， 用 于 检测 网 络 状态 
INIT DELAYED WORK(&db-^phy poll, dm9000 poll work); 
/获取 资源 
db->addr res — platform get resource(pdev, IORESOURCE MEM, 0); 
db--data res = platform get resource(pdev, IORESOURCE MEM, 1); 
if (!'db->addr res || !db-^data res) 1 
dev err(db-^dev, "insufficient resources addr=%p data=%p\n", 
db->addr res, db-^data res); 
ret - -ENOENT; 
goto out; 


j 
ndev->irq = platform get irq(pdev, 0); 
if (ndev->irq < 0) ( 
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dev_err(db->dev, "interrupt resource unavailable: %d\n",ndev->irq); 
ret = ndev-^irq; 
goto out; 
} 
db->irqg wake = platform get irq(pdev, 1); 
if (db->irqg wake >= 0) ( 
dev dbg(db--dev, "wakeup irq ?od Wn", db->irq wake); 
ret = request irq(db-^irq wake, dm9000 wol interrupt, 
IRQF SHARED, dev. name(db-»dev), ndev)j;// 申 请 网 络 唤醒 系统 中 断 


if (ret) { 
dev err(db-^dev, "cannot get wakeup irq (od) Wn", ret); 
) else ( 
PORA ed A i UT RE / 
ret—irq set irq wake(db-^irq wake, 1);// 将 irq. wake 设置 为 可 唤醒 系统 的 中 断 
if (ret) { 
dev err(db-dev, "irq %d cannot set wakeup (Vod)n",db-^irq wake, ret); 
ret = 0; 
) else ( 
irq set irq. wake(db-»irq wake, 0);// 检 测 成 功 ， 默 认 关 闭 网 络 唤醒 
db->wake supported = 1; 


} 
iosize = resource size(db->addr res); 
db->addr req= request mem region(db->addr res->start, iosize,pdev->name); 
if (db->addr req == NULL) 1 
dev err(db-^dev, "cannot claim address reg area n"); 
ret — -EIO; 
goto out; 
j 
db->io addr = ioremap(db-»addr res-»start, iosize);// 映 射 寄存 器 
if (db->io addr == NULL) 1 
dev err(db-^dev, "failed to ioremap address reg"); 
ret = -EINVAL; 
goto out; 
j 
iosize = resource size(db--data res); 
db->data req = request mem region(db-^data res-»start, 10size,pdev-^name); 
if (db-^data req == NULL) 1 
dev err(db-^dev, "cannot claim data reg area"); 
ret — -EIO; 
goto out; 
j 
db--io data = ioremap(db-»data res-»start, iosize); /映射 数据 地 址 
if (db->io data == NULL) { 
dev err(db-»dev, "failed to jioremap data regn"); 
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ret= -EINVAL; 
goto out; 
} 
ndev->base addr = (unsigned long)db->io addr; 
[i & IO routines*/ 
dm9000 set io(db, 10size); 
if (pdata != NULL) { 
if (pdata->flags & DM9000 PLATF 8BITONLY) 
dm9000 set io(db, 1); 
if (pdata-»flags & DM9000 PLATF 16BITONLY) 
dm9000 set io(db, 2); 
if (pdata-»flags & DM9000 PLATF 32BITONLY) 
dm9000 set io(db, 4); 
if (pdata->inblk != NULL) 
db->inblk = pdata-^inblk; 
if (pdata->outblk != NULL) 
db->outblk = pdata->outblk; 
if (pdata->dumpblk != NULL) 
db->dumpblk = pdata->dumpblk; 
db->flags = pdata->flags; 


} 
#ifdef CONFIG DM9000 FORCE SIMPLE PHY POLL 


db->flags = DM9000 PLATF SIMPLE PHY; 
#endif 
dm9000 reset(db); 
PHSE dS Hr ID*/ 
for (i =0; i < 8; it) ( 
id val = ior(db, DM9000 VIDL); 
id val |= (u32)ior(db, DM9000 VIDH) << 8; 
id val |= (u32)ior(db, DM9000 PIDL) << 16; 
id val |= (u32)ior(db, DM9000 PIDH) << 24; 
if (id val — DM9000 ID)break; 
dev err(db-^dev, "read wrong id 0x9608x n", id. val); 


} 
if (id val != DM9000 ID) 1 
dev_err(db->dev, "wrong id: 0x%08x\n", id. val); 


ret - -ENODEV; 
goto out; 

j 

AEA SAT CASSA 


id_val = ior(db, DM9000 CHIPR); 
dev dbg(db->dev, "dm9000 revision 0x9?602x n", id. val); 
switch (id val) { 
case CHIPR DM9000A: 
db->type = TYPE DM9000A; 
break; 
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case CHIPR DM9000B: 
db->type = TYPE DM9000B; 
break; 

default: 
dev dbg(db-^dev, "ID %02x => defaulting to DM9000EW", id. val); 
db->type = TYPE DM9000E; 

} 

/*dm9000a/b 支持 硬件 校 验 */ 

if (db->type == TYPE DM9000A || db->type == TYPE DM9000B) { 
ndev->hw features = NETIF F RXCSUM | NETIF F IP CSUM; 
ndev-»features |= ndev->hw features; 


j 
人 # 至 此 说 明 已 经 找到 一 个 DM9000， 进 一 步 配 置 接口 与 参数 */ 
ndev->netdev_ ops= &dm9000 netdev ops; 


ndev--watchdog timeo- msecs to jiffies(watchdog); 
ndev--ethtool ops= &dm9000 ethtool ops; 
db->msg enable = NETIF MSG LINK; 
db->mii.phy id mask = Ox1f 
db-^miireg num mask = Oxlf, 
db->mii.force media = 0; 
db->mii.full duplex = 0; 
db->mii.dev= ndev; 
db--mii.mdio read = dm9000 phy read; 
db->mii.mdio write= dm9000 phy write; 
mac src — eeprom"; 
PE. MAC 地 址 */ 
for (i =0; i <6; i +=2) 
dm9000 read eeprom(db, i / 2, ndev->dev addr+i); 
if (lis valid ether addr(ndev-^dev addr) && pdata != NULL) 1 
mac src — "platform data"; 
memoepy(ndev--dev addr, pdata-^dev addr, ETH ALEN); 


j 
if(!is valid ether addr(ndev-^dev addr)) ( 

mac src — "chip"; 
ndev--dev addr[0]-0x00; 
ndev--dev addri[1]-0xe0; 
ndev-^»dev addr[2]-0xa3; 
ndev-^»dev addr[3]-0xa4; 
ndev--dev addr[4]-0x98; 
ndev->dev addr[5]-0x67; 

j 

if(lis valid ether addr(ndev-^dev addr)) ( 
dev warn(db-»dev, "96s: Invalid ethernet MAC address. Please " 

"set using ifconfig n", ndev-^name); 

eth hw addr random(ndev); 


mac src — "random"; 
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} 
platform set drvdata(pdev, ndev); 
ret = register_netdev(ndev);// 注 册 网 络 设备 
if (ret == 0) 
printk(KERN INFO "%s: dm9000%c at %p,%p IRQ %d MAC: %pM (%s)\n", 
ndev->name, dm9000 type to_char(db->type)， 
db->io addr, db->io data, ndev->irg,ndev->dev addr, mac src); 


return 0; 
out: 
dev err(db--dev, "not found (Vod). n", ret); 
dm9000 release board(pdev, db); 
free netdev(ndev); 
return ret; 
} 


DM9000A 的 网 络 设备 操作 接口 定义 下 : 


static const struct net device ops dm9000 netdev ops = ( 
.ndo open = dm9000 open, 
.ndo stop = dm9000 stop, 


.ndo start xmit — dm9000 start xmit, 
.ndo tx timeout — dm9000 timeout, 
.ndo set rx mode — — dm9000 hash table, 
.ndo do ioctl = dm9000 ioctl, 

.ndo change mtu =eth change mtu, 

.ndo set features — dm9000 set features, 


.ndo validate addr = eth validate addr, 
.ndo set mac address = eth mac addr, 


JS 
dm9000 open 函数 


O 


VENE PAb: 


if (request_irq(dev->irq, dm9000 interrupt, IRQF_SHARED,dev->name, dev)) 
return -EAGAIN; 


这 里 分 析 两 个 最 重要 的 函数 。 第 一 个 是 发 送 函 数 dm9000_start_ xmit。 发 送 时 先 将 数据 写 
A TX SRAM 中 ， 然 后 将 包 长 写 入 TX 包 长 度 寄存 器 ， 最 后 将 TX 控制 寄存 器 的 0 位 设置 为 
1， 请 求 发 送 。 复 位 后 发 送 起 始 地 址 是 00OH， 当 前 的 包 是 I 包 。DM9000A 的 TX SRAM 中 可 
以 按照 顺序 同时 存储 两 个 发 送 包 ， 分 别 为 1 包 和 本 包 。I 包 发 完 后 继续 发 I[ 包 。 


static void dm9000 send packet(struct net device *dev,int ip summed,ul6 pkt len) 
1 
board info t *dm — to dm9000 board(dev); 
if (dm->ip summed != ip summed) { 
if (ip summed — CHECKSUM NONE) 
iow(dm, DM9000 TCCR, 0); 
else 
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iow(dm, DM9000 TCCR, TCCR IP| TCCR UDP|TCCR TCP); 
dm->ip summed = ip summed; 
j 
FRE TX 长 度 */ 
iow(dm, DM9000 TXPLL, pkt len); 
iow(dm, DM9000 TXPLH, pkt len >> 8); 
PORXEGRS 
iow(dm, DM9000 TCR, TCR. TXREQ); 


j 


static int dm9000 start xmit(struct sk buff *skb, struct net device *dev) 
1 
unsigned long flags; 
board info t *db = netdev priv(dev); 
dm9000 dbg(db,3, "%s:\n", func ); 
if (db-^tx pkt cnt 1) 
return NETDEV TX BUSY; 
spin lock irqsave(&db--lock, flags); 
/*1f data 移 到 DM9000 TX RAM*/ 
writeb(DM9000 MWCMD, db--io addr); 
(db-—outbIk)(db-^io data, skb-^data, skb--len); 
dev-»stats.tx bytes += skb->len; 
db-^tx pkt cnt++; 
PORE EBEN 
if (db-^tx pkt cnt — 1) ( 
dm9000 send packet(dev, skb-^ip summed, skb--len); 
yelse 1 
EREA 
db->queue pkt len = skb->len; 


db->queue ip summed = skb->ip summed; 
netif stop queue(dev); 

j 

spin unlock irqrestore(&db-^lock, flags); 

dev kfree skb(skb); /* X Jit SKB*/ 

return NETDEV TX OK; 


包 发 送 完毕 将 引起 中 断 ， 并 调用 dm9000 tx done 函数 完成 后 处 理 。 
第 二 个 重要 的 函数 是 中 断 处 理 函 数 dm9000_interrupt: 


static irqreturn t dm9000 interrupt(int irq, void *dev id) 
1 

struct net device *dev = dev 1d; 

struct board info *db = netdev priv(dev); 

int int status; 

unsigned long flags; 

u8 reg save; 

dm9000 dbg(db, 3, "entering Yos", — func); 
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spin lock irqsave(&db->lock, flags); 
reg save = readb(db->io addr); 
dm9000 mask interrupts(db); 
AZRE E BASS 
int_status = ior(db, DM9000_ISR); 
iow(db,DM9000 ISR,int status);  /* y5 pr 
if (netif msg intr(db)) 
dev dbg(db--dev, "interrupt status %02x\n", int. status); 
rgo p er 
if (int status & ISR. PRS) 
dm9000 rx(dev); 
POR TRUBEN/ 
if (int status & ISR. PTS) 
dm9000 tx done(dev, db); 
if (db->type != TYPE DM9000E) { 
if (int status & ISR LNKCHNOG) { 
PORGEL SE ER E BEAR EAE 
schedule delayed work(&db-^phy poll, 1); 


} 
dm9000 unmask interrupts(db); 
writeb(reg save, db->io_ addr); 
spin unlock irqrestore(&db--lock, flags); 
return IRO HANDLED; 

} 


DM9000A 的 接收 缓冲 (RX SRAM) 是 一 个 环形 的 数据 结构 。 系 统 复位 后 RX SRAM 的 
始 地 址 是 0x0C00。 每 个 接收 到 的 数据 包 包 含 一 个 AB 的 包头 、 包 数据 以 及 CRC 校 验 值 。 
4B 的 头 数 据 包 括 01h、 状 态 、 字 节 长 度 低位 、 字 节 长 度 高 位 。 注 意 每 个 包 的 开始 地 址 必须 按 
照 操作 模式 (如 8 位 、16 位 、32 位 ) 对 齐 。dm9%000 rx 函数 的 处 理 过 程 如 下 : 


static void dm9000 rx(struct net device *dev) 
{ 
struct board info *db = netdev priv(dev); 
struct dm9000 rxhdr rxhdr; 
struct sk buff *skb; 
u8 rxbyte, *rdptr; 
bool GoodPacket; 
int RxLen; 
POR E LER I 
do { 
ior(db, DM9000 MRCMDX); 
P158 gc Rn 
rxbyte = readb(db-^1o data); 
PORA UIS / 
if (rxbyte & DM9000 PKT ERR) {// 包 错误 


339 


Linux 驱动 程序 开发 实例 第 2 版 


dev warn(db->dev, "status check fail: %d\n", rxbyte); 


iow(db, DM9000 RCR, 0x00); /*£ 1E Ut 4&*/ 
return; 

j 

if (I(rxbyte & DM9000 PKT RDY))V 如 果 包 未 就 绪 ， 返 回 
return; 


FURA KRSI KE*/ 
GoodPacket = true; 
writeb(DM9000 MRCMD, db->io_addr); 
(db-^inbIk)(db--io data, &rxhdr, sizeof(rxhdr)); 
RxLen = lel6 to cpu(rxhdr.RxLen); 
if (netif msg rx status(db)) 
dev dbg(db--dev, "RX: status %02x, length 9604x n",rxhdr.RxStatus, RxLen); 
POE ue, 
if (RxLen « 0x40) ( 
GoodPacket — false; 
if (netif msg rx err(db)) 
dev dbg(db--dev, "RX: Bad Packet (runt)n"); 
} 
if (RxLen > DM9000 PKT MAX) { 
dev dbg(db--dev, "RST: RX Len:?ox n", RxLen); 
j 
/状态 检测 
if (rxhdr.RxStatus & (RSR FOE | RSR CE| RSR AE | 
RSR PLE|RSR RWTO |RSR LCS |RSR RF)) ( 
GoodPacket — false; 
if (rxhdr.RxStatus & RSR FOE) ( 
if(netif msg rx err(db)) 
dev dbg(db--dev, "fifo error"); 
dev-»stats.rx fifo errors; 
j 
if (rxhdr.RxStatus & RSR CE) { 
if(netif msg rx err(db)) 
dev dbg(db--dev, "crc error"); 
dev-»stats.rx crc errors; 
j 
if (rxhdr.RxStatus & RSR RF) f 
if(netif msg rx err(db)) 
dev dbg(db--dev, "length error"); 
dev-»stats.rx length errors; 


} 

/*  DM9000 移出 数据 */ 

if (GoodPacket &&((skb = netdev alloc skb(dev, RxLen + 4)) != NULL)) { 
skb reserve(skb, 2); 
rdptr = (u8 *) skb put(skb, RxLen - 4); 
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/*Read received packet from RX SRAM*/ 
(db-^inblk)(db-^1o data, rdptr, RxLen); 
dev-»stats.rx bytes += RxLen; 
Pri ESI 
skb->protocol = eth type trans(skb, dev); 
if (dev-^features & NETIF F RXCSUM) { 
if ((((rxbyte & Ox1c) << 3) & rxbyte) = 0) 
skb-^ip summed = CHECKSUM UNNECESSARY; 
else 
skb checksum none assert(skb); 
j 
netif rx(skb); 
dev-»stats.rx packets; 
) else ( 
/打印 包 数据 %/ 
(db->dumpblk)(db->io_data, RxLen); 
} 
} while (rxbyte & DM9000 PKT RDY); 
j 


至 此 DM9000A 的 收发 过 程 介绍 完毕 。 


13.2.3 DM9000A 网 卡 驱 动 程序 移植 


本 节 介 绍 如 何在 S3C6410X 平台 上 移植 DM9000A 豫 动 程序 。 
例 13.3 DM9000A 驱动 程序 移植 实例 
(1) 设置 S3C6410X 的 GPIO LH: 


void initDM9000() 

1 
unsigned int tmp; 
writel((read(S3C64XX  GPNPUD) &-(0x3««14)),53C64XX. GPNPUD); 
// EINT7 高 电 平 触发 
writel((readl(S3C64XX EINTOCONO) & -(0x7 ««12)) | (0x1 << 12), S3C64XX. EINTOCONO); 
writel((readl(S3C64XX EINTOFLTCONO)& -(0x3 ««6)) | (0x1 << 7), S3C64XX. EINTOFLTCONO); 
writel((read(S3C64XX EINTOPEND)&-(0x1««7)),53C64XX. EINTOPEND); 
writel(read(S3C64XX EINTOMASK) & -(0x1 << 7), S3C64XX EINTOMASK);*EINT7 unmask*/ 


j 


static int — devinit dm9000 probe(struct platform device *pdev) 


1 
initDM9000(); 


} 
(2) 修改 MAC 地 址 如 下 : 


static int — devinit dm9000 probe(struct platform device *pdev) 


1 
Jr 


341 


Linux 驱动 程序 开发 实例 第 2 版 


/*for (1= 0; i< 6; i++) 
ndev-^»dev addr[i] = ior(db, 13-DM9000 PAR);*/ 

ndev--dev addr[0]-0x00; 
ndev--dev addri[1]-0xe0; 
ndev--dev addr[2]-0xa3; 
ndev--dev addr[3]-0xa4; 
ndev--dev addr[4]-0x98; 
ndev--dev addr[5]-0x67; 


} 
(3) 在 /arch/arm/mach-s3c6400/include/mach/map.h 中 添加 网 卡 地 址 : 


"define S3C64XX PA_DM9000 (0x18000000)// 物 理 地 址 为 SROM 第 二 区 (CSn1) 的 地 址 
#define SAaC64XX SZ DM9000 SZ IM 
define S3C64XX VA DM9000 S3C ADDR(0x03b00300) 


(4) Œ linux/arch/arm/plat-s3c64xx/dev-uart.c 中 添加 DM9000 资源 : 


#define DM9000 ETH IRQ EINTO IRQ EINT(7) 
static struct resource dm9000 resources cs1[] = 


.start = S3C64XX PA DM9000 + 0x300, 
.end = S3C64XX_PA_DM9000 + 0x300 + 0x03, 
.flags = IORESOURCE_MEM 


.start = S3C64XX_PA_DM9000 + 0x300 + 0x4, 
.end = S3C64XX PA DM9000 + 0x300 + 0x4 + 0x7f, 
.flags = IORESOURCE_MEM 
) 
[2]- 1 
.start = DM9000 ETH IRQ EINTO, 
.end - DM9000 ETH IRQ EINTO, 
.flags - IORESOURCE IRQ 


h 
static struct dm9000 plat data dm9000 setup csl = { 
.flags = DM9000 PLATF 16BITONLY 


h 

struct platform device s3c device dm9000 cs1 = { 
.name = "dm9000", 
id =0, 


.num resources — ARRAY SIZE(dm9000 resources csl), 
resource = dm9000 resources csl, 
dev ={ 

.platform data = &dm9000 setup csl, 
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h 
EXPORT SYMBOL(s3c device dm9000 cs1); 


(5) 在 arch/arm/mach-s3c6410/mach-smdk6410.c 的 设备 结构 体 中 添加 设备 信息 : 


static struct platform device *smdk6410 devices[]  initdata — 


1 
&s3c device dm9000 csl, 


j 
(6) 执行 make menuconfig， 进 入 网 络 配置 ， 如 图 13-6 与 图 13-7 所 示 。 


General setup 777? 
[*] Enable loadable module support 一 -一 
—*- Enable the black layer 一 -一 > 
System Type 一 -一 > 
Bus support 一 -一 > 
Kernel Features 一 一 
Boot options 一 -一 > 
CPU Power Management 一 一 一 > 
Floating point emulation 一 -一 > 
Userspace binary formats 一 -一 > 
Power management options 一 -一 > 
Networking support 一 -一 > 
Device Drivers 一 -一 > 


图 13-6 配置 网 络 支持 


€ > Packet socket 
“<*> Unix domain sockets 
X5 UNIX: socket monitoring interface 
M > Transformation user configuration interface 
Transformation sub policy support 
Transformation migrate database 
Transformation statistics 
< > PF KEY sockets 
] TCP/IP networking 

pP 

n 


x 


: multicasting 

: advanced router 
FIB TRIE statistics 

P: policy routinz 

P: equal cost multipath 

IP: verbose route monitoring 

* P: kernel level autoconfiguration 
P: DHCP support 

* IP: BOOTP support 

P: RARP support 

ok» P: tunneling 

<> IP: GRE demultiplexer 


图 13-7 配置 网 络 协议 


配置 【device drivers】 中 的 选项 ， 如 图 13-8 所 示 : 


Generic Driver Options 一 -一 > 
Bus devices ~-—» 
€ ? Connector - unified userspace <-> kernelspace linker 一- 一 
Sk» Memory Technology Dewice (MID) support ---} 
—k- Device Tree and Üpen Firmware support 一 -一 > 


< > Parallel port support -———- 
[t] Block dewices 一 -一 > 
Misc devices -——5 
SCSI device support ---> 
> Serial ATA and Parallel ATA drivers (libata) 一 -一 
] Multiple devices driver support (RAID and LYM) ---- 
> Generic Target Core Mod (TCM) and ConfigFS Infrastructure- 
] Network device support 一 -一 > 
] Oópen-Channel 55D target support -———- 
Input dewice support 一 一 一 > 


图 13-8 device drivers 配置 
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配置 【device drivers] -> [network device support] -> [Ethernet driver support】 中 的 选 
项 ， 如 图 13-9 所 示 。 


-——- Ethernet driver support 
<> Altera Triple-Speed Ethernet MAC support 
ARC dewices 
kurora VLSI devices 
Cadence devices 
Broadcom devices 
Cirrus dewices 
DMO0OO support 
Force simple NSR based PHY polling 
Dave ethernet support (DNET) 
EZchip devices 


Le car aia 


图 13-9 配置 DM9000A 以 太 网 支持 


运行 结果 如 下 : 


dm9000 Ethernet Driver, V1.31 
eth0: dm9000a at c886e300,c8872304 IRQ 108 MAC: 00:e0:a3:a4:98:67 (chip) 
eth0: link up, 100Mbps, full-duplex, Ipa 0x45E1 


[root@urbetter /]£ ping 192.168.1.120 

PING 192.168.1.120 (192.168.1.120): 56 data bytes 

64 bytes from 192.168.1.120: seq-0 ttl=64 time-1.404 ms 
64 bytes from 192.168.1.120: seq-1 ttl=64 time-0.509 ms 
64 bytes from 192.168.1.120: seq-2 ttl=64 time-0.755 ms 
64 bytes from 192.168.1.120: seq=3 ttl=64 time-0.545 ms 
ao 

--- 192.168.1.120 ping statistics --- 

4 packets transmitted, 4 packets received, 096 packet loss 
round-trip min/avg/max = 0.509/0.803/1.404 ms 


13.4 ethtool 


ethtool 是 用 来 查询 与 设置 网 络 参 数 的 命令 。 内 核 提供 的 ethtool IOCTL 接口 如 下 : 


#define SIOCETHTOOL — 0x8946/*Ethtool 接口 */ 
int dev ioctl(struct net *net, unsigned int cmd, void — user *arg) 


1 


case SIOCETHTOOL: 
dev load(net, ifrifr name); 
rtnl lock(); 
ret = dev ethtool(net, &ifr); 
rtnl unlock(); 
if (!ret) { 
if (colon)*colon = ':'; 
if (copy to user(arg, &ifr,sizeof(struct ifreq))) 
ret = -EFAULT; 
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} 


return ret; 


另外 ethtool.h 中 有 ethtool 子 命令 定义 。net_device 结构 中 有 一 个 ethtool 操作 成 员 


Cethtool ops)， 用 来 处 理 ethtool 命令 : 


struct ethtool ops { 


int 
int 
void 
int 
void 
void 
int 
u32 
void 
int 
u32 
int 
int 
int 
int 
int 
void 
int 
void 
int 
void 
void 
int 
void 
int 
void 
u32 
int 
int 
int 
int 
int 
int 
u32 
u32 
int 
int 
void 
int 


(*get settings)(struct net device *, struct ethtool cmd *); 

(*set settings)(struct net device *, struct ethtool cmd *); 

(*get drvinfo)(struct net device *, struct ethtool drvinfo *); 

(*get regs len)(struct net device *); 

(*get regs)(struct net device *, struct ethtool regs *, void *); 

(*get wol)(struct net device *, struct ethtool wolinfo *); 

(*set wol)(struct net device *, struct ethtool wolinfo *); 

(*get msglevel)(struct net device *); 

(*set msglevel)(struct net device *, u32); 

(*nway reset)(struct net device *); 

(*get link)(struct net device *); 

(*get eeprom len)(struct net device *); 

(*get eeprom)(struct net device *,struct ethtool eeprom *, u8 *); 
(*set eeprom)(struct net device *,struct ethtool eeprom *, u8 *); 
(*get coalesce)(struct net device *, struct ethtool coalesce *); 

(*set coalesce)(struct net device *, struct ethtool coalesce *); 

(*get ringparam)(struct net device *,struct ethtool ringparam *); 
(*set ringparam)(struct net device *,struct ethtool ringparam *); 
(*get pauseparam)(struct net device *,struct ethtool pauseparam*); 
(*set pauseparam)(struct net device *,struct ethtool pauseparam*); 
(*self test)(struct net device *, struct ethtool test *, u64 *); 

(*get strings)(struct net device *, u32 stringset, u8 *); 

(*set phys id)(struct net device *, enum ethtool phys id state); 
(*get ethtool stats)(struct net device *,struct ethtool stats *, u64 *); 
(*begin)(struct net device *); 

(*complete)(struct net device *); 

(*get priv flags)(struct net device *); 

(*set priv flags)(struct net device *, u32); 

(*get sset count)(struct net device *, int); 

(*get rxnfc)(struct net device *,struct ethtool rxnfc *, u32 *rule locs); 
(*set rxnfc)(struct net device *, struct ethtool rxnfc *); 

(*flash device)(struct net device *, struct ethtool flash *); 
(*reset)(struct net device *, u32 *); 

(*get rxfh key size)(struct net device *); 

(*get rxfh indir size)(struct net device *); 

(*get rxfh)(struct net device *, u32 *indir, u8 *key,u8 *hfunc); 
(*set rxfh)(struct net device *, const u32 *indir,const u8 *key, const u8 hfunc); 
(*get channels)(struct net device *, struct ethtool channels *); 
(*set channels)(struct net device *, struct ethtool channels *); 
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25 
DM9000A 的 驱动 中 ethtool 操作 接口 如 下 : 


static const struct ethtool ops dm9000 ethtool ops = { 


.get drvinfo — dm9000 get drvinfo, 
get settings — dm9000 get settings, 
Set settings — dm9000 set settings, 
.get msglevel — dm9000 get msglevel, 
.Set msglevel — dm9000 set msglevel, 
.nway reset — dm9000 nway reset, 
get link — dm9000 get link, 

.get wol — dm9000 get wol, 

.Set wol — dm9000 set wol, 

.get eeprom len — dm9000 get eeprom len, 
.get eeprom — dm9000 get eeprom, 
.Set eeprom — dm9000 set eeprom, 


ls 
下 面 是 ethtool 命令 使 用 实例 : 


/获取 eth0 信息 
[root@urbetter home] ./ethtool -ieth0 
driver: dm9000 
Version: 1.31 
firmware-version: 
expansion-rom-version: 
bus-info: dm9000 
supports-statistics: no 
supports-test: no 
supports-eeprom-access: yes 
supports-register-dump: no 
supports-priv-flags: no 
/获取 eth0 特性 
[root@urbetter home]# ./ethtool eth0 
Settings for eth0: 
Supported ports: [ TP MII ] 
Supported link modes: — 1ObaseT/Half 1ObaseT/Full 
100baseT/Half 100baseT/Full 
Supported pause frame use: No 
Supports auto-negotiation: Yes 
Advertised link modes:  1ObaseT/Half 1ObaseT/Full 
100baseT/Half 100baseT/Full 
Advertised pause frame use: No 
Advertised auto-negotiation: Yes 
Link partner advertised link modes: | lObaseT/Half 1ObaseT/Full 
100baseT/Half 1 00baseT/Full 
Link partner advertised pause frame use: Symmetric 
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Link partner advertised auto-negotiation: Yes 


Speed: 100Mb/s 
Duplex: Full 
Port: MII 
PHYAD: 0 
Transceiver: internal 
Auto-negotiation: on 
Supports Wake-on: d 
Wake-on: d 
Current message level: 0x00000004 (4) 
link 
Link detected: yes 
/关闭 eth0 自动 协商 
[root(Qurbetter home]# ./ethtool -s eth0 autoneg off 
// 验 证 一 下 关闭 是 否 成 功 
[root@urbetter home]# ./ethtool eth0 
Settings for eth0: 
Supported ports: [ TP MII ] 


Supported link modes: 
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10baseT/Half 10baseT/Full 


100baseT/Half 100baseT/Full 


Supported pause frame use: No 
Supports auto-negotiation: Yes 
Advertised link modes: 
Advertised pause frame use: No 
Advertised auto-negotiation: No 
Speed: 100Mb/s 

Duplex: Full 

Port: MII 

PHYAD: 0 

Transceiver: internal 


Not reported 


Auto-negotiation: off 
Supports Wake-on: d 
Wake-on: d 
Current message level: 0x00000004 (4) 
link 
Link detected: yes 
/设置 eth0 网 速 


[root@Ourbetter home]# ./ethtool -s eth0 speed 10 duplex full 


dm9000 dm9000.0 eth0: link down 


dm9000 dm9000.0 eth0: link up, 10Mbps, full-duplex, Ipa Ox45E1 


[root(Qurbetter home | ./ethtool -s eth0 autoneg on 
dm9000 dm9000.0 eth0: link down 


dm9000 dm9000.0 eth0: link up, 100Mbps, full-duplex, Ipa Ox45E1 


13.5 PHY 芯片 驱动 


使 用 独立 外 部 PHY 芯片 时 ， 需 要 有 PHY 4548 


K 动 。 通 常 PHY 芯片 的 寄存 器 定义 都 差 不 
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多 ， 使 用 内 核 的 通用 PHY 芯片 驱动 即 可 。 通 用 PHY 驱动 见 driversmnetphyphy_device.c。 


static struct phy. driver genphy driver[] = { 
1 
.phy. id= Oxffffffff, 
.phy_ id mask- Oxffffffff, 
.name- "Generic PHY", 
.Soft reset — genphy soft reset, 
config init = genphy config init, 
.features- PHY GBIT FEATURES | SUPPORTED MI | 
SUPPORTED AUI|SUPPORTED FIBRE SUPPORTED BNC, 
config aneg = genphy config aneg, 
.aneg done = genphy aneg done, 
ead status = genphy read status, 
.suspend = genphy suspend, 


Tesume= genphy resume, 


.phy. id- OxfFffffff, 

.phy_ id mask= Oxffffffff, 

.name = "Generic 10G PHY", 
.soft_reset = genlOg soft reset, 
config init- genlOg config init, 
.features- 0, 

config aneg = genlOg config aneg, 
ead status- genlOg read status, 
.Suspend- genlOg suspend, 


.resume- genl0g resume, 


h 
static int init phy init(void) 
1 
int rc; 
rc = mdio bus init(); 
if (rc)return rc; 
rc = phy drivers register(genphy driver, ARRAY SIZE(genphy driver), THIS MODULE); 
if (rc)mdio bus exit(); 
return rc; 


j 


内 核 有 一 个 phy state machine 工作 队列 将 不 断 调 用 genphy _ read status 函数 来 检测 PHY 
状态 。 当 使 用 独立 PHY 芯片 时 ， 网 络 设备 需要 从 关联 的 PHY 设备 获取 当前 网 络 信 息 ， 
在 net device 结构 中 ，phy_device 结构 的 *phydev 成 员 记 录 了 这 种 连接 关系 。phy_connect HW 
数 将 PHY 设备 与 网 络 设备 连接 起 来 : 


struct phy device *phy connect(struct net device *dev, const char *bus id, 
void (*handler)(struct net device *),phy interface t interface) 
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bus id HJ PHY 的 ID。 使 用 独立 PHY 已 片 的 网 络 设备 与 自 带 PHY 功能 的 网 络 设备 (如 
DM9000) 在 处 理 ethtool 命令 时 方法 是 不 同 的 。 拿 第 一 个 ethtool 命令 来 分 析 : 


#define ETHTOOL GSET 0x00000001 /* 获 取 网 卡 设置 .所 
int dev ethtool(struct net *net, struct ifreq *ifr) 
1 


switch (ethcmd) { 
case ETHTOOL GSET: 
rc — ethtool get settings(dev, useraddr); 
break; 


j 


ethtool get settings 函数 调用 的 是 ethtool ops-»get settings: 


int ethtool get settings(struct net device *dev, struct ethtool cmd *cmd) 
{ 

ASSERT RTNL(; 

if (!dev-^ethtool ops->get settings) 

return -EOPNOTSUPP; 

memset(cmd, 0, sizeof(struct ethtool cmd)); 

cmd->cmd = ETHTOOL GSET; 

return dev-^ethtool ops-»get settings(dev, cmd); 


} 
先 看 DM9000 的 get_settings， 调 用 的 是 mii ethtool gset: 


static int dm9000 get settings(struct net device *dev, struct ethtool cmd *cmd) 


1 
struct board info *dm —to dm9000 board(dev); 
mii ethtool gset(&dm-^mii, cmd); 
return 0; 
j 
int mil ethtool gset(struct mii if info *mii, struct ethtool cmd *ecmd) 
{ 


struct net device *dev = mii-^dev; 
ul6 bmcr, bmsr, ctr11000 — 0, stat1000 — 0; 
u32 nego; 
ecmd-»supported = 
(SUPPORTED 10baseT Half| SUPPORTED 10baseT Full| 
SUPPORTED 100baseT Half| SUPPORTED 100baseT Full | 
SUPPORTED Autoneg | SUPPORTED TP | SUPPORTED MII); 
if (mii-^supports gmii) 
ecmd-»^supported |= SUPPORTED 1000baseT Half |SUPPORTED 1000baseT Full; 
ecmd-^port = PORT MII; 
ecmd--transceiver = XCVR. INTERNAL; 
ecmd-^phy address = mii-^phy id; 
ecmd-^mdio support = ETH MDIO SUPPORTS C22; 
ecmd-»advertising = ADVERTISED TP | ADVERTISED MII; 
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j 


Ej S3C6410X 加 DM9000 的 组 合 不 同 ，TI 的 Davinci 处 理 器 通常 


bmcr = mii->mdio read(dev, mii->phy id, MII BMCR); 
bmsr = mii->mdio read(dev, mii-^phy id, MII BMSR); 
if (mii-^supports gmil) { 


ctr11000 = mii->mdio read(dev, mii-^phy id, MII CTRL 1000); 


stat1000 = mii-^mdio read(dev, mii-^phy id, MII STAT 1000); 


mii->full duplex = ecmd-^duplex; 
return 0; 


都 自 带 MAC f 


但 需要 外 接 一 个 PHY 芯片 。Davinci EMAC 驱动 初始 化 时 连接 了 一 个 PHY 设备 : 


priv->phydev = phy_connect(ndev, priv->phy id,&emac adjust link,PHY INTERFACE MODE MUID) 


了 看 内 核 中 Davinci EMAC 驱动 的 get. settings 接口 实现 如 下 : 


static int emac get settings(struct net device *ndev,struct ethtool cmd *ecmd) 


1 


j 


struct emac priv *priv — netdev priv(ndev); 
if (priv->phydev) 

return phy ethtool gset(priv-^phydev, ecmd); 
else 

return -EOPNOTSUPP; 


int phy ethtool gset(struct phy device *phydev, struct ethtool cmd *cmd) 


1 


j 


可 见 emac get settings 直接 通过 PHY 设备 获取 设置 。 


cmd->supported = phydev->supported; 
cmd->advertising = phydev->advertising; 
cmd->lp_advertising = phydev->lp_advertising; 
ethtool cmd speed set(cmd, phydev->speed); 
cmd->duplex = phydev-»duplex; 
if (phydev--interface == PHY INTERFACE MODE MOCA) 
cmd->port - PORT BNC; 
else 
cmd->port = PORT MII; 
cmd->phy address = phydev-7mdio.addr; 
cmd->transceiver = phy is internal(phydev) ? 
XCVR INTERNAL: XCVR EXTERNAL; 
cmd--autoneg = phydev->autoneg; 
cmd->eth tp mdix ctrl = phydev-^mdix; 
return 0; 


例 13.4 ETIOIIC 芯片 不 支持 1000M 网 络 分 析 
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UEM 


E 


使 用 ethtool 命令 查看 eth0 网 络 参数 ， 结 果 如 下 ; 


root@/home:~# ethtool eth0 
Settings for eth0: 


Supported ports: [ TP AUI BNC MII FIBRE ] 


Supported link modes: 
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l0baseT/Half 10baseT/Full 


100baseT/Half 100baseT/Full 


Supports auto-negotiation: Yes 
Advertised link modes: 


IObaseT/Half lObaseT/Full 


100baseT/Half 100baseT/Full 


Advertised pause frame use: No 
Advertised auto-negotiation: Yes 
Speed: 100Mb/s 

Duplex: Full 

Port: MII 

PHYAD: 1 

Transceiver: external 
Auto-negotiation: on 

Link detected: yes 


ET1011C 芯片 本 身 支 持 1000M 网 络 ， 但 以 


sn 


结果 却 显示 并 未 文 持 1000M 网 络 。 分 


析 phy. device.c 代码 : 


int genphy config init(struct phy device *phydev) 


{ 
int val; 
u32 features; 


features = (SUPPORTED TP | SUPPORTED MIIISUPPORTED AUI| SUPPORTED FIBRE | 
SUPPORTED BNC | SUPPORTED Pause | SUPPORTED Asym Pause); 


PPS 


val = phy. read(phydev, MII BMSR);// 基 本 模式 状态 寄存 器 


if (val <0) 
return val; 
if (val & BMSR ANEGCAPABLE) 
features |= SUPPORTED Autoneg; 
if (val & BMSR 100FULL) 
features |- SU 
if (val & BMSR 100HALF) 
features |- SU 
if (val & BMSR 10FULL) 
features |- SU 
if (val & BMSR 10HALF) 
features |- SU 
if (val & BMSR ESTATEN) ( 


PPORTED 100baseT Full; 


PPORTED l100baseT Half; 


PPORTED lObaseT Full; 


PPORTED lObaseT Half, 


val = phy. read(phydev, MII ESTATUS);// 扩 展 状 态 寄存 器 


if (val « 0) 


return val; 
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if(val & ESTATUS 1000 TFULL) 
features |= SUPPORTED 1000baseT Full; 
if(val & ESTATUS 1000 THALF) 
features |= SUPPORTED 1000baseT Half, 


j 
phydev-»supported &- features; 
phydev--advertising &- features; 


return 0; 
j 
查找 芯片 手册 中 MIL ESTATUS 寄存 器 信息 ， 见 表 13-7: 
表 13-7 ET1011C MII ESTATUS 寄存 器 
Bit 名 W 描 述 类 型 默认 值 说 — UJ 
15 1000Base-X Full duplex 0= 不 支持 1000Base-X Full duplex RO 0 -- 
14 1000Base-X Half duplex 0= 不 支持 1000Base-X Half duplex RO 0 -- 
1= 文 持 1000Base-T Full duplex 本 bit 的 值 是 复位 时 
is 1000 Base-T. DIR 0= 不 支持 1000Base-T Full duplex m i SPEED 1000 管 脚 的 值 
1= 支 持 1000Base-T Half duplex 
12 1000Base-T Half duplex 0= 不 支持 1000Base-T Half duplex RO 1 -- 
11:0 保留 -- RO 0 -- 
可 见 13 位 是 从 SPEED 1000 管 脚 读 取 的 。 这 个 管 脚 是 个 复 用 管 脚 ， 复 位 时 ， 用 来 配置 
1000M 网 支持 。 复 位 时 这 个 管 脚 电 平 为 1， 寄 存 器 值 就 是 1; 这 个 管 脚 电 平 为 0， 则 寄存 器 
值 为 0。 焊 接 相 应 的 电阻 ， 将 该 管 脚 电 平 拉 高 ， 使 用 ethtool 命令 查看 网 络 参数 : 


root@/home:~# ethtool eth0 
Settings for eth0: 


Supported ports: [ TP AUI BNC MII FIBRE ] 


Supported link modes: 


10baseT/Half 10baseT/Full 


100baseT/Half 100baseT/Full 
1000baseT/Half 1000baseT/Full 


Supports auto-negotiation: Yes 
Advertised link modes: 


10baseT/Half 10baseT/Full 


100baseT/Half 100baseT/Full 
1000baseT/Half 1000baseT/Full 


可 见 芯 片 已 支持 1000M 网 络 。 
13.6 Netlink Socket 


13.6.1 Netlink 机 制 


‘`g 


Netlink 是 Linux 内 核 与 应 用 程序 之 间 的 一 利 


>F 


羊 ， 内 核 将 Netlink 作为 一 利 
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网 络 协议 族 来 处 理 。Netlink 协议 在 RFC3549 H 


信 机 制 ， 像 TCP 与 UDP 等 网 络 协议 一 
HAE X. TE Linux 
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内 核 中 ，Netlink 使 用 专门 的 内 核 Netlink API， 而 在 应 用 层 调用 标准 的 socket. API 就 可 以 使 

] Netlink 机 制 提供 的 强大 功能 。Netlink 的 数据 传递 单元 为 Netlink 消息 。Netlink 不 仅 文 持 

单 播 ， 而 且 支 持 多 播 。 如 果 内 核 模块 或 应 用 把 Netlink 消息 发 送 给 一 个 Netlink 组 ， 属 于 该 Netlink 

组 的 任何 内 核 模块 或 应 用 都 能 接收 到 该 消息 。 本 节 将 介绍 Linux 内 核 中 的 Netlink 机 种 
内 核 中 Netlink socket 使 用 下 面 的 结构 描述 : 


Am 


o 


struct netlink sock { 


/*struct sock 必须 是 netlink sock 的 第 一 个 成 员 */ 
struct sock sk; 

u32 portid;// 本 sock ïi 

u32 dst_portid;// 目 的 端口 

u32 dst group; // 目 的 组 

u32 flags; 

u32 subscriptions; 

u32 ngroups; /多 播 组 数量 


unsigned long *groups; /多 播 组 号 
unsigned longstate; 

size t max recvmsg len; 
wait queue head t wait; 


bool bound; 
bool cb running; 
struct netlink callback cb; 


struct mutex  *cb mutex; 
struct mutex cb def mutex; 


void (*netlink rcv)(struct sk buff *skb); 
int (*netlink bind)(struct net *net, int group); 
void (*netlink unbind)(struct net *net, int group); 
struct module *module; 

#ifdef CONFIG NETLINK MMAP 
struct mutex pg vec lock; 


struct netlink ring — rx ring; 

struct netlink ring — tx ring; 

atomic t mapped; 
#endif /*CONFIG NETLINK MMAP*/ 

struct rhash head ^ node; 

struct rcu head ICU; 


Js 
netlink 是 以 协议 族 形式 在 内 核 中 注册 的 。 注 册 过 程 如 下 : 


Ter. 


// netlink 协议 族 

static struct proto netlink proto = ( 
.name -— "NETLINK", 
.Owner — THIS MODULE, 
.obj size = sizeof(struct netlink sock), 
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static struct pernet operations — net initdata netlink net ops = 1 
nit = netlink net init, 
.exit = netlink net exit, 

5 

static const struct net proto family netlink family ops = ( 
family = PF NETLINK, 
.create — netlink create, 
.owner- THIS MODULE, 


h 
static int init netlink proto init(void) 
1 
int i; 
int err = proto register(&netlink proto, 0);// 注 册 netlink 协议 族 
if (err != O)goto out; 
netlink add usersock entry(); 
sock register(&netlink family ops);/TEJJ] netlink 对 应 的 socket 协议 处 理 方法 
register pernet subsys(&netlink net ops);// 注 册 网 络 命名 空间 子 系统 
rtnetlink init(); 
out: 
return err; 
panic: 
panic("netlink init: Cannot allocate nl table"); 
} 


在 内 核 模块 中 ， 可 以 使 用 netlink kernel create 函数 创建 一 个 Netlink socket: 


struct sock *netlink kernel create(struct net *net, int unit, struct netlink kernel cfg *cfg); 


参数 unit 表示 Netlink 协议 类 型 。 内 核 预 定义 的 协议 类 型 有 如 下 类 型 : 
#define NETLINK ROUTE 0* 路 由 器 */ 
#define NETLINK UNUSED 1 
#define NETLINK USERSOCK 2 
define NETLINK FIREWALL 3 谨防 火 墙 */ 
#define NETLINK INET DIAG 4 
define NETLINK NFLOG 5 
define NETLINK XFRM 6 
define NETLINK SELINUX 7/*selinux 防火 墙 */ 
#define NETLINK. ISCSI 8 
define NETLINK AUDIT 9 
define NETLINK FIB LOOKUP 10 
define NETLINK CONNECTOR 11 
#define NETLINK_NETFILTER 12 
#define NETLINK IP6 FW 13 
#define NETLINK DNRTMSG 14 
Zdefine NETLINK KOBJECT UEVENT 15/*Kobject 事件 */ 
Zdefine NETLINK GENERIC 16/*388 Netlink 协议 */ 
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Zdefine NETLINK SCSITRANSPORT 18 
ildefine NETLINK ECRYPTFS 19/*]] 98 SC QT AR ERI 
netlink kernel cfg 结构 定义 如 下 : 

struct netlink kernel cfg { 
unsigned int groups;// 组 信息 
unsigned int flags; 
void (*input)(struct sk buff*skb);/ 消 息 到 达 回 调 
struct mutex *cb mutex; 
int (*bind)(struct net *net, int group);/ZH ZB XE 
void (*unbind)(struct net *net, int group);// 组 解 绑 定 
bool (*compare)(struct net *net, struct sock *sk); 


js 


上 面 的 input 成 员 函 数 是 Netlink 消息 处 
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HERG MAMANA Netlink socket 时 ， 


input 函数 指针 就 会 被 引用 ， 传 递 给 input 函数 的 参数 是 sk. buff 结构 。 


Netlink 消息 结构 由 Netlink 消息 头 加 数据 组 成 。Netlink 消息 头 结构 是 nlmsghdr: 
struct nlmsghdr 
1 
. u32 nlmsg len; 3 BOE AS RES/ 
. ul6 nlmsg type;/# 消 息 类 型 所 
. ul6 nlmsg flags; 放 附加 标志 */ 
w2 nlmsg seq;/* 序 列 号 */ 
. u32 nlmsg _ pid;/# 发 送 消 息 者 的 进程 ID*/ 
H 
nlmsghdr 结构 的 nlmsg_flags 字段 用 于 设置 消息 标志 ， 可 用 的 标志 包括 : 
#define NLM F REQUEST 1i S YE dn 
#define NLM F MULTI 2/8 EA S BAI 
#define NLM F ACK A/*ACK*/ 
define NLM F ECHO 8/*isisk BIN */ 
ildefine NLM F ROOT 0x100 
#define NLM F MATCH 0x200 
itdefine NLM F ATOMIC 0x400 
Zdefine NLM F DUMP (NLM F ROOTINLM F MATCH) 
ildefine NLM F REPLACE 0x100 /*18 ui OAT E 
#define NLM F EXCL 0x200 PNE IEEE 
#define NLM F CREATE 0x400 居 如 果 不 存 在 则 创建 六 
define NLM F APPEND 0x800 /*3ÉJn$ Fe A7 


内 核 中 网 络 消息 是 通过 sk. buff 


成 员 中 。 当 内 核 ! 发 送 Netlink 消息 时 ， 需要 设置 H 标 地 址 与 源 地 ] 


结构 来 管理 的 ，Netlink 消息 通常 放置 在 sk buff 的 data 


lE; NETLINK CB 宏 用 来 


返回 保存 在 sk. buff 的 cb 成 员 中 的 netlink skb parms 结构 ，netlink_skb_parms 中 存放 着 一 些 


地 址 信息 /CN 
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#define NETLINK CB(skb) (*(struct netlink skb parms*)&((skb)->cb)) 
下 面 是 一 个 消息 地 址 设置 的 例子 : 


， 一 般 内 核 设置 为 0 


NETLINK. CB(skb). portid 0; /消息 发 送 者 端 
NETLINK CB(skb).dst group =1;/ 目 标 组 地 址 。 


在 内 核 中 可 以 调用 函数 netlink unicast 来 发 送 单 播 消息 : 


int netlink unicast(struct sock *ssk, struct sk buff *skb,u32 portid, int nonblock) 


ssk 是 netlink kernel create 函数 返回 的 Netlink 套 接 字 。 


skb 是 网 络 数据 结构 ， 其 


data 成 员 用 来 存放 Netlink 消息 。portid 参数 为 目的 端口 ， 通 常 为 接收 消息 的 进程 的 ID。 


nonblock 为 阻塞 标志 ， 如 果 为 MSG DONTWAIT, XRX HJER 


缓存 则 立即 返回 ， 如 果 为 0， 表 示 阻 塞 方式 ， 此 时 如 果 没 有 接收 缓存 则 睡眠 等 待 。 


LI 


昌 塞 方式 ， 此 时 如 果 没 有 接收 


内 核 模块 或 子 系统 也 可 以 使 用 函数 netlink broadcast 来 发 送 广播 消息 : 


int netlink broadcast(struct sock *ssk, struct sk buff *skb, u32 portid,u32 group, gfp t allocation); 


参数 ssk, skb 与 portid 的 含义 与 netlink unicast 函数 的 参数 相同 。 本 次 广播 将 不 发 送 给 


]- 


(513.5 内核 Netlink 广播 发 送 实 例 
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#define NETLINK EXAMPLE 32 

struct sk buff *skb = NULL; 

struct nlmsghdr *nlh; 

int ret; 

struct sock *sock; 

static void netlink rcv(struct sk buff *skb) 


1 


/在 此 接收 netlink 消息 
} 
struct netlink kernel cfg cfg — { 
input = netlink rcv, 
h 
sock = netlink kernel create(&init net, NETLINK EXAMPLE, &cfg); 
skb = nlmsg new(NLMSG DEFAULT SIZE, GFP ATOMIC); 
if (skb == NULL )return; 
/填充 广播 包 
NETLINK CB(skb).portid = 0; 
NETLINK CB(skb).dst group = 0; 
nlh = (struct nlmsghdr *)skb->data;// 指 向 数据 位 
nlh->nlmsg len = NLMSG SPACE(1000); 
nlh-^nlmsg pid = 0; 
nlh-^nlmsg flags = 0; 
strcpy(NLMSG DATA(nlh), HELLO WORLD!"); 
I ERES 


端口 ID 为 portid 的 Netlink socket. group 为 接收 Netlink 消息 的 多 播 组 组 号 。 allocation 为 内 
存 分 配 标志 ， 包 括 GFP ATOMIC 和 GFP KERNEL 等 。 
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netlink broadcast(sock, skb, 0, 1,GFP ATOMIC); 


13.6.2 Netlink 应 用 层 编程 


网 络 设备 驱动 程序 


Netlink 应 用 层 使 用 标准 的 socket 套 接 字 与 内 核 通 信 。 标 准 的 socket API 的 函数 


socket, bind, sendmsg, recvmsg 和 close 都 可 以 应 用 到 Netlink socket. 


的 使 用 步骤 。 
创建 一 个 Netlink socket: 


socket(AF NETLINK, SOCK RAW, netlink type); 


下 面 介 绍 Netlink socket 


Netlink 对 应 的 协议 族 是 AF_NETLINK， 第 二 A a Us 


或 SOCK DGRAM (数据 报 套 接 字 )， 第 三 个 参数 指定 netlink 协议 类 型 


义 的 类 型 ， 也 可 以 使 用 内 核 预定 义 的 类 型 ， 参 见 netlink kernel create 函数 的 units 
bind 函数 需要 绑 定 协议 地 址 。Netlink 的 socket 地 址 使 用 sockaddr nl 结构 表示 : 


struct Sockaddr nl 


1 
sa family t nl family; *AF NETLINK */ 
unsigned short nl pad; 
. u32 nl_pid;/* 接 收 消息 者 的 进程 DD， 为 0 表示 消息 接收 者 为 内 核 或 多 播 组 */ 
. u32 nl groups;/* 多 播 组 */ 
h 


sockaddr nl 结构 中 的 成 员 nl family 为 协议 族 AF NETLINK, R nl pad 当前 没有 使 


用 ， 因 此 要 总 是 设置 为 0， 成 员 nl_pid 为 接收 或 发 送 消息 的 进程 的 


消息 或 多 播 消息 ， 就 把 该 字段 设置 为 0， 否 则 设置 为 处 理 消息 的 进程 DD。 成 员 nl groups 用 


ID， 如 果 希 望 内 核 来 处 理 


R2H, ， 如 果 设 置 为 0， 表示 


于 指定 多 播 组 ，bind 函数 用 于 把 调用 进程 加 入 到 该 字段 指定 的 多 捐 
调用 者 不 加 入 任何 多 播 组 。 


消息 的 形式 如 下 : 


struct msghdr { 
void * msg name;  /*socket 名 */ 
int msg namelen;/* 44 fq K BE*/ 
struct iovec * msg. iov; PORREEUSI 


. kernel size t msg_iovlen;/* 数 据 块 数量 */ 


void *msg control; 
. kernel size t msg controllen; 


unsigned msg flags; 
Ji 
13.6.3 Netlink 驱动 程序 实例 
例 13.6 Netlink 驱动 程序 与 应 用 实例 


用 户 空间 可 以 调用 socket 套 接 字 的 send 函数 向 内 核发 送 消 息 ， 如 sendto、sendmsg 等 。 


本 例 使 用 Netlink 实现 内 核 与 应 用 层 的 交互 。 代 码 见 \samples\13network\13-2netlink。 
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创建 内 核 Netlink 套 接 字 代码 如 下 : 


struct sock *nl sk= NULL; 
static int init netlink(void) 


1 
struct netlink kernel cfg cfg = 1 
.groups- CN NETLINK USERS + Oxf, 
input = sample input, 
h 
nl sk — netlink kernel create(&init net, NETLINK SAMPLE, &cfg); 
if (!nl sk) 
1 
printk("net link: Cannot create netlink socket. n"); 
return -EIO; 
j 
printk("net_link: create socket ok.\n"); 
return 0; 
j 
int init module() 
1 
init netlink(); 
return 0; 
j 


内 核 Netlink 套 接 字 收 到 消息 会 调用 sample input 函数 。 本 例 中 sample input KAHIJI 


能 是 将 应 用 层 发 来 的 数据 原 相 
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发 回应 用 层 ; 


T 


void sample input (struct sk buff*  skb) 
1 

struct sk buff *skb; 

struct nlmsghdr *nlh; 

unsigned int pid; 

int rc; 

int len = NLMSG SPACE(1200); 

char data[ 100]; 

int dlen-0; 

skb —skb get( skb); 

if (skb->len >= NLMSG SPACE(0)) 

1 
nlh = nlmsg hdr(skb); 
dlen- nIh-^nlmsg len; 
pid = nlh-7nlmsg pid;/# 将 消息 ID 设置 为 目的 端口 */ 
这 dlen>100)dlen=100; 
memset(data,0,100); 
memcpy(dataNLMSG DATA (nlh).dlen); 
printk("net link: recv '%s' from process od. Wn", data,pid); 
kfree skb(skb); 


} 


应 有 
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skb = alloc skb(len, GFP_ATOMIC);// 分 配 sk. buff 
if (!skb) 
1 
printk("net link: alloc skb failed. n"); 
return; 
j 
nlh = nlmsg put(skb,0,0,0,1200,0);//]H] skb 添加 一 个 netlink 消息 
nlh -^nlmsg len-dlen; 
NETLINK CB(skb).portid = 0; 
memcpy(NLMSG DATA(nlh), data, strlen(data)); 
rc = netlink unicast(nl sk, skb, pid, MSG _ DONTWAIT);/ 发 送 单 播 消息 


if (rc < 0) 
1 
printk("net link: unicast skb error"); 
j 
printk("net link: send '%s' to process %d ok. n", data,pid); 
j 
return; 


zB F: 


int main(int argc, char* argv[]) 


{ 


struct sockaddr nl src addr, dest addr; 

struct nlmsghdr *nlh = NULL; 

struct iovec iov; 

int sock. fd; 

struct msghdr msg; 

// PF NETLINK 5 AF NETLINK 相同 

sock fd= socket(PF NETLINK, SOCK RAW, NETLINK SAMPLE); 
memset(&msg, 0, sizeof(msg)); 

memset(&src addr, 0, sizeof(src addr)); 

src addr.nl family = AF NETLINK; 

src addr.nl pid = getpid(); 

src addr.nl groups = 0; 

bind(sock fd, (struct sockaddr*)&src addr, sizeof(src addr)); 
memset(&dest addr 0, sizeof(dest addr)); 

dest addr.nl family - AF NETLINK; 

dest addr.nl pid = 0; 

dest addr.nl groups = 0; 

nlh-(struct nlImsghdr *)malloc(NLMSG SPACE(MAX PAYLOAD)); 
nlh-^nlmsg len = NLMSG SPACE(MAX PAYLOAD); 
nlh-^nlmsg pid = getpid(); 

nlh-^nlmsg flags = 0; 

strcpy(NLMSG DATA(nlh), "Hello kernel!"); 

lov.iov base = (void *)nlh; 
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j 


lov.iov len = nlh-^nlmsg len; 

msg.msg name = (void *)&dest addr; 

msg.msg namelen = sizeof(dest addr); 

msg.msg iov — &iov; 

msg.msg iovlen - 1; 

sendmsg(sock fd, &msg, 0); 

printf("Send message payload: %s\n",NLMSG DATA(nlh)); 
memset(nlh, 0, NLMSG SPACE(MAX PAYLOAD)); 
recvmsg(sock fd, &msg, 0); 

printf(" Received message payload: 96s", NLMSG DATA(nlh)); 
close(sock fd); 


本 例 运 行 结果 如 下 : 
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[root(Qjurbetter drivers |? insmod netlink.ko 


net link: create socket ok. 

[root(a)urbetter drivers |? ./test 

net link: recv 'Hello kernel!" from process 1246. 
net link: send 'Hello kernel!' to process 1246 ok. 
Send message payload: Hello kernel! 


Received message payload: Hello kernel! 


备 类 型 。 另 外 Linux 内 核 还 支持 USB Gadget JKz/J, XA 
。 在 Linux 操作 系统 下 ， 只 要 是 遵循 USB 规范 的 设备 ， 通 常 不 安装 驱动 就 可 以 使 用 。 本 
体系 基础 、Linux 内 核 中 的 USB 设备 驱动 架构 ， 并 分 析 S3C6410X 的 USB 


Cm 
c ] 


章 章 主要 介绍 USB 


^B 14 2$ USB 驱动 程序 


Linux 内 核对 USB 设备 的 支持 非常 完善 。 作 为 USB 主机 ， 


主机 控制 器 驱动 程序 。 


14.1 USB 体系 概述 


14.1.1 USB 系统 组 成 
般 由 一 个 USB 主机 、 一 个 或 多 个 USB 集线器 和 一 个 或 多 个 USB 设备 节点 组 


USB 系统 一 
o USB HUB 用 于 设备 扩展 连接 ， 所 有 USB 设备 都 连接 在 USB HUB 的 端口 上 
机 总 与 一 个 根 HUB (USB ROOT HUB) 相连 。USB 系统 的 拓扑 结构 如 图 


图 14-1 USB 系统 拓扑 结构 


14.1.2 USB 主机 
在 任何 USB 系统 中 通常 仅 有 一 台 主 机 (Host)。 主 机 系统 


Tier 4 


中 USB 接口 称 


它 支 持 几 乎 所 有 通用 USB X 
EF 系统 可 以 作为 一 个 USB 从 设备 使 


。 一 个 USB 主 
14-1 所 示 。 


为 主机 控制 器 
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C50 为 连接 的 USB 设备 提供 


日 


; 
3 
HUS 


(Host Controller). USB 主机 是 USB 总 线 的 核心 部 分 ， 它 的 任务 包括 : 
(1) 检测 USB 设备 的 连接 和 拆除 。 

(2) 管理 主机 和 USB 设备 之 间 的 控制 流 。 

(3) 管理 主机 和 USB 设备 之 间 的 数据 流 。 


USB 主机 的 设计 必须 遵循 主机 控制 器 的 设计 规范 。USB1.1 协议 中 包括 OHCI (Open Host 
Controller Interface Specification) 和 UHCI (Universal Host Controller Interface Specification ) 规 


范 。UHCI 对 硬件 的 要 求 较 少 ， 
的 功能 定义 在 硬件 中 ， 软 件 处 型 
总 线 上 包 的 传输 。 包 在 帧 ' 
Frame) 包 ， 用 于 同步 帧 的 3 
USB 2.0 中 增加 了 EHCI (Enhanced Host Controller Interface) ， 它 为 USB 2.0 主机 高 速 
E， 大 大 简化 了 USB 2.0 的 主机 设计 ， 提 
速 与 低速 设备 ， 为 了 兼容 USB 1.1, USB 2.0 的 


有 旦 对 系统 的 处 到 


的 复杂 度 降 


传输 ， 在 每 帧 
Tf 始 和 跟踪 帧 的 数目 。 


E 能 力 与 软件 的 开发 要 求 较 高 ，OHCI 则 把 较 多 
氏 ， 对 系统 的 要 求 也 较 低 。USB 主机 控制 器 控制 
主 控 器 产生 一 个 帧 开始 〈SOF，Start of 


数据 传输 控制 器 的 软 硬 件 设 计 提 供 了 统 


高 了 软件 的 可 移植 性 。EHCI 本 身 并 不 支持 


HC H EHCI 和 CHC (Companion Host Controller， 包 括 OHCI 4l UHCI 等 ) 两 部 分 组 成 。 


14.1.3 USB 设备 逻辑 层次 


USB 设备 在 多 辑 上 分 成 了 几 个 层次 ， 分 别 是 设备 层 、 配 置 层 、 接 口 层 和 端点 层 ， 如 


DS 


县 。 每 个 设备 内 有 


备 可 以 有 多 组 接口 ， 每 一 组 接口 


与 设备 进行 通信 。 


来 源 或 目的 。 


本 
即 可 使 用 。 其 他 通 
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点 是 一 个 
两 个 0 号 端点 组 成 上 
道上 只 在 设备 被 配置 后 才 可 以 使 用 。 


14-2 所 示 。 设 备 层 描述 设备 的 总 体 信息 ， 包 括 厂 商 D, USB 协议 版 本 、 设 备 类 型 等 信 


个 或 多 个 逻辑 连接 点 ， 称 为 端点 ， 接 口 是 由 一 组 相关 的 端点 组 成 的 。 设 
共用 一 个 配置 。 


14-2 USB 设备 中 各 层 关系 


USB 设备 对 于 USB 系统 来 说 是 一 个 端点 的 集 
口 ， 设 备 端点 和 主机 软件 之 间 利 月 


端点 被 分 成 组 ， 一 组 端点 实现 一 个 接 
设备 驱动 程序 就 是 通过 这 些 接口 和 管道 来 


US 可 寻 址 部 分 ， 是 主机 与 设备 之 间 通 信 的 


由 通道 。 一 旦 设备 加 电 并 复位 后 ， 此 通道 


gpu: 
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Linux 内 核 USB 设备 的 结构 如 下 : 


struct usb device { 
int devnum; 
char devpath[16]; 
u32 route; 
enum usb device state state; 
enum usb device speed speed; 
structusb tt "tt; 
int ttport; 
unsigned int toggle[2 ]; 
struct usb device *parent; 
struct usb bus *bus; 
struct usb host endpoint ep0;// 端 口 0 
struct device dev; 
struct usb device descriptor descriptor; 
struct usb host bos *bos; 
struct usb host config *config; 
struct usb host config *actconfig; 
struct usb host endpoint *ep_in[16];/ 输 入 端口 
struct usb host endpoint *ep_out[16];// 输 出 端 
char **rawdescriptors; 
unsigned short bus mA; 
u8 portnum; 


Jis 
Linux 内 核 中 USB 配置 的 结构 如 下 : 


struct usb host config { 
struct usb config descriptor desc;// 配 置 描述 符 
char *string;/* 配 置 字 符 串 */ 
struct usb interface assoc descriptor *intf assoc[USB MAXIADS]; 
struct usb interface *interfaceBUSB MAXINTERFACESJ]; /* 配 置 关 联 的 接口 */ 
struct usb interface cache *intf cache[USB MAXINTERFACES]; 
unsigned char *extra; — /x* 其 他 描述 符 */ 
int extralen;// 其 他 描述 符 长 度 


s 
Linux 内 核 中 USB 主机 接口 的 结构 如 下 : 


struct usb host interface { 
struct usb interface descriptor desc;// 接 口 描述 符 


int extralen; 

unsigned char *extra; — HAUTE 

struct usb host endpoint *endpoint;// 关 联 的 端点 
char *string;/* 接 口 字 符 串 并 
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Linux 内 核 中 USB 主机 端点 的 结构 如 下 : 


struct usb host endpoint { 


struct usb endpoint descriptor desc;// 端 点 描述 符 
struct usb ss ep comp descriptor ss ep comp; 
struct list head urb list; 

void *hepriv; 

struct ep device *ep dev; /* HHF sysfs*/ 


unsigned char *extra; — HAUT 


int extralen;// 
int enabled; 


int streams; 


14.2 Linux USB 


其 他 描述 符 长 度 


驱动 程序 体系 


14.2.1 USB 总 体 结 核 
Linux 下 的 USB 驱动 程序 体系 结构 如 图 14-3 所 示 。 


文件 系统 与 应 用 


USB 设 备 驱动 〈 含 存储 类 、 人 机 接口 类 (HID)、 通 信 类 等 ) 


USB 主 机 控制 右 驱 动 


图 14-3 Linux 下 的 USB 驱动 程序 体系 


USB 主机 控制 器 负责 USB 接口 通信 和 USB 数据 传输 。USB 主机 控制 器 马 


系统 设备 驱动 的 混合 。U 
类 包括 USB 打印 设备 、 


SB 设备 类 驱动 一 般 是 与 平台 无 关 的 。Linux 内 核 支持 上 


14.22. USB 设备 驱动 
USB 核心 层 使 用 usb_driver 来 标识 一 个 USB 设备 驱动 ， 该 结构 定义 如 下 : 


struct usb driver { 


const char *name; 
int (*probe) (struct usb interface *intf,const struct usb device id *id); 
void (*disconnect) (struct usb interface *intf); 
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管理 USB 主机 控制 器 。USB 核心 层 负 责 USB MEE, USB 协议 栈 等 。USB 设备 类 驱动 
负责 与 应 用 交互 ， 它 往往 是 一 种 混合 型 驱动 。 例 如 USB 鼠标 驱动 是 USB 设备 可 


区 动 与 输入 子 
I USB 设备 


通信 类 设备 、HID 设备 类 、 存 储 设备 类 、 语 音 设备 类 等 。 
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int (Funlocked ioctl) (struct usb interface *intf, unsigned int code,void *buf); 
int (*suspend) (struct usb interface *intf, pm message t message); 
int (*resume) (struct usb interface *intf); 

int (*reset resume)(struct usb interface *intf); 

int (*pre reset)(struct usb interface *intf); 

int (*post reset)(struct usb interface *intf); 

const struct usb device id *id table; 

struct usb dynids dynids; 

struct usbdrv wrap drvwrap; 

unsigned int no dynamic 1d:1; 

unsigned int supports autosuspend:1; 

unsigned int disable hub initiated lpm:1; 

unsigned int soft unbind:1; 


Jis 
USB 设备 驱动 注册 注销 接口 如 下 : 


#define usb register(driver) V 

usb register driver(driver, THIS MODULE, KBUILD MODNAME) 
void usb deregister(struct usb. driver *); 
/下 面 为 简洁 的 USB 驱动 注册 与 注销 宏 ， 当 不 需要 在 初始 化 与 退出 时 做 其 他 特殊 操作 时 使 用 
#define module usb driver( usb driver) 

module driver( usb driver, usb register, \ 


usb deregister) 


usb driver 注册 后 ， 当 USB 核心 层 发 现 新 的 USB 设备 与 之 匹配 时 ， 会 调用 usb driver 
的 probe 函数 。 


14.23 USB 设备 


USB 核心 层 使 用 usb. device 结构 来 标识 一 个 USB 设备 ， 该 结构 定义 如 下 : 


struct usb device ( 


int devnum;// 在 总 线 上 的 序号 
char devpath[16];//USB 拓扑 路 径 
u32 route; 

enum usb device state state;// 状 态 


enum Usb device speed speed;//3 HE 
struct usb tt *#tt/ 事 务 转换 《如 高 速 接口 兼容 低速 设备 ) 
int ttport; 


unsigned int toggle[2 ]; 

struct usb device *parent; 

struct usb bus *bus; 

struct usb host endpoint ep0;// 端 点 0 

struct device dev; 

struct usb device descriptor descriptor;// 设 备 描述 符 
struct usb host bos *bos; 

struct usb host config *config; 
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当 HUB 检测 到 设备 连接 ， 就 会 分 配 一 个 usb_device， 注 册 到 总 线 设备 列表 中 ， 


5 


struct usb host config *actconfig; 
struct usb host endpoint *ep_ in[16];// 输 入 端点 
struct usb host endpoint *ep_out[16];// 输 出 端点 


char **rawdescriptors;//GET_ DESCRIPTOR 命令 返回 的 描述 符 原始 字符 


unsigned short bus_mA;// 电 流 
u8 portnum;//HUB 端口 号 

u8 level;//USB 设备 树 层级 
unsigned can submit:1; 


unsigned persist enabled:1; 
unsigned have langid:1; 

unsigned authorized:1; 

unsigned authenticated:1; 

unsigned wusb:1; 

unsigned lpm capable:1; 

unsigned usb2 hw lpm capable:1; 
unsigned usb2 hw lpm besl capable:1; 
unsigned usb2 hw lpm enabled:1; 
unsigned usb2 hw lpm allowed:1; 
unsigned usb3 lpm ul enabled:l; 
unsigned usb3 lpm u2 enabled:1; 
int string langid; 


配 相应 的 驱动 。 


14.2.4 主机 控制 器 驱动 
usb_hcd 结构 用 来 标识 一 个 USB 主机 控制 器 驱动 : 
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struct usb hcd 1 


struct usb bus self; /#hcd 本 身 是 bus*/ 

struct kref kref; 1*5 Hi 

const char *product desc; /*] RI FIF R */ 

int speed; 人/# 根 hub 的 速度 */ 

char irq descr[24]; /*driver + bus #*/ 

struct timer list rh timer; /*drives root-hub polling*/ 
struct urb *status urb; — /*^A B FAS urb*/ 


#ifdef CONFIG PM 


#endif 
const struct hc_driver *driver; [RES EE hooks 函数 */ 
//OTG 与 一 些 主机 控制 器 需要 与 PHY 交互 
struct usb phy *usb phy; 
struct phy *phy; 
unsigned long flags; 


struct work struct — wakeup work; /*Xcflfe le H]*/ 


py 


然后 
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unsigned int irg; /* R T 

void _ iomem *regs; P3 N TETOS/ 

resource size t rsrc start; 诺 内 存 /IO 资源 起 始 */ 

resource size t rsrc len; FAFAO 资源 长 度 */ 

unsigned power budget; 放电 源 预算 ， 单 位 为 mA, 0= 无 限制 */ 


struct giveback urb bh high prio_bh; 
struct giveback urb bh low prio bh; 


struct mutex *bandwidth mutex;//1i 9s H. 
struct usb hcd *shared hed; 

struct usb hcd *primary hcd; 

struct dma pool *pool[HCD BUFFER POOLS]; 
int state; 


unsignedlonghcd priv[0] attribute — ((aligned(sizeof(s64))));// fA 2 


HI 


je 
usb add hcd 用 来 添加 USB 主机 控制 器 驱动 : 


int usb add hcd(struct usb hcd *hcd,unsigned int irqnum, unsigned long irqflags); 


中 irqnum 为 中 断 号 ，irqflags 为 中 断 标 志 。 


14.2.5 USB 请 求 块 urb 
USB 体系 的 各 个 模块 之 间 使 用 USB 请 求 块 Curb) 进行 信息 传递 。urb 结构 如 下 : 


struct urb ( 
ŽL FA: usb 核心 层 或 主机 控制 器 用 */ 
struct kref kref, /*URB 引用 计数 */ 
void *hcpriv; 上 主机 控制 器 私有 数据 凑 
atomic tuse count; JETER CS) 
atomic t reject; 
int unlinked; 


此 以 下 公用 :可 被 驱动 使 用 的 成 员 */ 
struct list head urb list; 
struct list head anchor list; 


struct usb anchor *anchor; 


struct usb device *dev; PB V */ 
struct usb host endpoint *ep; /*r 4 */ 
unsigned int pipe; PEE RA 
unsigned int stream id; /# 流 ID*/ 

int status; PES I 
unsigned int transfer flags; —/*E 4p Ejes */ 
void *transfer buffer; POR Ep 


dma addr ttransfer dma; ”传输 绥 冲 的 DMA 地 址 */ 
struct scatterlist *sg; 
int num mapped sgs; 


int num sgs; 
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u32 transfer buffer length; ”/* 数 据 缓冲 长 度 */ 
u32 actual length; PESE Pty RENI 


unsigned char *setup packet; /*£E 78, (控制 专用 )*/ 
dma addr tsetup dma; 上 建立 包 DMA 地 址 */ 
int start frame; 访 开 始 帧 (ISO)*/ 

int number of packets; /*ISO 包 数 量 */ 

int interval; /x 传输 间隔 (INT/ISO)*/ 
int error count; /*ISO 错误 数量 */ 

void *context; l*S6 SEAT E P OCS/ 

usb complete tcomplete; — /* SEX RAF Ei 


struct usb iso packet descriptor iso frame desc[0];/#* 用 于 ISO*/ 
5 


创建 一 个 urb 使 用 下 面 的 函数 : 


struct urb *usb alloc urb(intiso packets, gfp t mem flags); 


iso packets 代表 等 时 数据 包 的 数量 ， 如 果 不 创建 等 时 urb 则 该 值 为 0。mem flags 为 创建 
标志 。 释 放 一 个 urb 使 用 下 面 的 函数 : 


void usb free urb(struct urb *urb); 


usb submit urb 用 来 提交 USB 请 求 块 : 


int usb submit urb(struct urb *urb, gfp t mem flags); 


usb submit urb 是 个 异步 调用 ， 它 会 立即 返回 ， 提 交 的 urb 被 放 入 处 理 队 列 ， 处 理 完毕 
会 调用 struct urb-> complete ŽK, complete 函数 的 定义 如 下 : 


typedef void (*usb complete t)(struct urb *); 


要 取消 提交 的 请 求 ， 可 以 用 usb_unlink_ urb 函数 或 usb_kill urb 函数 。 


intusb unlink urb(struct urb *urb);// 不 等 待 成 功 就 返回 
void usb kill urb(struct urb *urb);// 等 待 取消 成 功 


USB 文 持 四 种 基本 的 数据 传输 模式 ， 控 制 传输 、 同 步 传 输 、 中 断 传输 、 批 量 传 输 。 控 制 
传输 方式 支持 双向 传输 ， 用 来 处 理 主 端 口 到 USB 从 端口 的 数据 传输 ， 包 括 设备 控制 指令 、 
设备 状态 查询 及 确认 命令 。 对 于 高 速 设备 ， 人 允许 数据 包 最 大 容量 为 8，16，32 或 64B， 对 于 
低速 设备 只 有 SB 一 种 选择 。 同 步 传输 是 一 种 周期 的 、 连 续 的 单 向 传输 方式 ， 通 常用 于 与 时 
间 有 密切 关系 的 信息 的 传输 。 同 步 传输 每 次 传输 的 最 大 有 效 负 荷 可 为 1024B。 中 断 传 输 用 于 
非 周期 的 、 自 然 发 生 的 、 数 据 量 很 小 的 信息 的 传输 ， 主 要 用 在 键盘 、 鼠 标 及 操纵 杆 等 设备 
上 。 批 量 传输 方式 也 是 一 种 单 向 传输 ， 用 于 大 量 的 、 对 时 间 没 有 要 求 的 数据 传输 。 

usb fill int urb 用 来 填充 中 断 传 输 模 式 的 urb: 


i— 


n 


static inline void usb fill int urb(struct urb *urb,struct usb device *dev,unsigned int pipe, 
void *transfer buffer,int buffer length, 
usb complete t complete fn,void *context,int interval) 
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urb->dev = dev; 

urb->pipe = pipe; 

urb->transfer_buffer = transfer buffer; 

urb->transfer_buffer_length = buffer length; 

urb->complete = complete fn; 

urb->context = context; 

if (dev->speed == USB SPEED HIGH || dev->speed == USB SPEED SUPER) { 
PH ie i] Br er BERI / 
interval = clamp(interval, 1, 16); 


urb--interval = 1 << (interval - 1); 
} else 1 
urb--interval = interval; 


j 


urb->start frame = -1; 


j 
usb fill control urb 用 来 填充 控制 传输 模式 的 urb: 


static inline void usb fill control urb(struct urb *urb,struct usb device *dev,unsigned int pipe, 
unsigned char *setup packet,void *transfer buffer, 
int buffer length,usb complete t complete fn,void *context) 


urb->dev = dev; 

urb->pipe = pipe; 

urb->setup_packet = setup packet; 
urb->transfer_buffer = transfer buffer; 
urb->transfer_buffer_length = buffer length; 
urb->complete = complete fn; 

urb->context = context; 


} 
usb fill bulk urb 用 来 填充 批量 传输 模式 的 urb: 


static inline void usb fill bulk urb(struct urb *urb,struct usb device *dev,unsigned int pipe, 
void *transfer bufferint buffer length, 
usb complete t complete fn,void *context) 


urb->dev = dev; 

urb->pipe = pipe; 

urb-^transfer buffer = transfer buffer; 
urb-^transfer buffer length = buffer length; 
urb-»complete = complete fn; 

urb->context = context; 


j 


Linux 内 核 没 有 提供 专门 的 函数 用 来 填充 同步 模式 的 ub， 同 步 模式 的 urb 需要 设置 
URB ISO_ASAP 标志 : 
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urb->dev = dev->udev; 
urb->context = dev; 
urb->pipe = usb_revisocpipe(dev->udev, 0x83); 
urb->transfer flags = URB ISO ASAP; 
urb-^transfer buffer = dev-^adev.transfer buffer[i]; 
urb--interval = 1; 
urb->complete = em28xx audio isocirq; 
urb-^number of packets = EM28XX NUM AUDIO PACKETS; 
urb--transfer buffer length = sb size; 
for (j = k = 0; j < EM28XX NUM AUDIO PACKETS; 
j++, k += EM28XX AUDIO MAX PACKET SIZE) ( 
Urb->iso frame desc[j].offset = k; 
urb->iso frame desc[j].length =EM28XX AUDIO MAX PACKET SIZE; 


j 


下 面 几 个 USB 数据 发 送 函 数 为 同步 型 函数 ， 用 于 创建 一 个 urb， 并 将 其 发 送出 去 ， 等 待 
处 理 结 束 。 这 些 函数 均 不 能 用 于 中 断 上 下 文 。 从 函数 名 称 不 难看 出 其 数据 传输 模式 。 


int usb_control msg(struct usb device *dev, unsigned int pipe, — u8 request, 
. u$8requesttype, ul6 value, ul6 index, void *data, ul6 size, int timeout); 
intusb interrupt msg(struct usb device *usb dev, unsigned int pipe, 
void *data, int len, int *actual length, int timeout); 
int usb bulk msg(struct usb device *usb dev, unsigned int pipe, 
void *data, int len, int *actual length, int timeout); 


14.3 USB 设备 枚 举 


内 核 使 用 usb. get. descriptor 函数 获取 设备 的 描述 符 : 


int usb get descriptor(struct usb device *dev, unsigned char type,unsigned char index, void *buf, int size) 


基本 的 描述 符 的 类 型 包括 : 


#define USB DT. DEVICE 0x01 
#define USB DT CONFIG 0x02 
#define USB DT. STRING 0x03 
#define USB DT INTERFACE 0x04 
#define USB DT. ENDPOINT 0x05 
#define USB DT DEVICE QUALIFIER 0x06 
#define USB DT OTHER SPEED CONFIG 0x07 
#define USB DT INTERFACE POWER 0x08 


kis USB 设备 的 组 织 结构 ， 设 备 挂 载 时 ， 内 核 依次 获取 设备 描述 符 、 
口 描述 符 、 端 点 描述 符 。 基 本 的 描述 符 定义 如 下 : 
/设备 描述 符 


struct usb device descriptor { 


置 描 述 符 、 接 


cu 
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. u8 bLength; /此 描述 符 的 字 节 数 
. u8 bpDescriptorType;// 描 述 符 种 类 为 设备 
_u16 bcdUSB;// 此 设备 与 描述 符 兼容 的 USB 设备 说 明 版 本 号 (BCD 1) 
. u8 bpDeviceClass/ 设 备 类 码 
. u8 bDeviceSubClass:/ 设 备 子 类 码 
. u8 ”bDeviceProtocol;// 协 议 码 
. u8 bMaxPacketSize0;// 端 点 0 的 最 大 包 大 小 〈 仅 8,16,32,64 为 合法 值 ) 
_ul6 idVendor;//) 商标 志 
. ul6 idProduct;// 产 品 标志 
”ul16 bcdDevice;// 设 备 发 行 号 (BCD fU) 
. u8 ”iManufacturer;// 描 述 厂商 信息 的 字 串 的 索引 
. u8 ”iProduct;// 描 述 产 品 信息 的 字 串 的 索引 
. u8 ”iSeriaINumber;// 描 述 设备 序列 号 信息 的 字 串 的 索引 
. u8 bNumConfigurations; // 此 设备 支持 的 配置 数 
} attribute — ((packed)); 
/配置 描述 符 
struct usb config descriptor ( 
. u8 bLength;/ 此 描述 符 的 字 节 数 
. u8 bpDescriptorType;// 配 置 描述 符 类 型 
. ul6 wTotalLength;// 此 配置 信息 的 总 长 
. u8 bNumInterfaces;/ 此 配置 所 支持 的 接口 个 数 
. u8 bConfigurationValue;/ 用 作 SetConfiguration 命令 的 参数 
. u8 icConfiguration;/ 描 述 此 配置 的 字 串 描述 符 索 引 
_ u8 bmAttributes;/ 电 源 配置 特性 
. u8 bMaxPower;/ 在 此 配置 下 的 总 线 电源 耗费 量 
) attribute — ((packed)); 
/接口 描述 符 
struct usb interface descriptor { 
. u8 bLength;/ 此 描述 符 的 字 节 数 
. u8 bDescriptorType; // 接 口 描述 符 > 
_u8 bmterfaceNumber:// 接 口号 : 当前 配置 支持 的 接口 数组 索引 ， 从 零 开始 
. u8 ”bAlternateSetting;// 可 选 设置 的 索引 值 
. u8 bNumEndpoints:/ 此 接口 用 的 端点 数量 


. u8 bnterfaceClass;/ 类 值 : 零 值 为 将 来 的 标准 保留 。 如 果 此 域 的 值 设 为 FFH， 则 此 接 
类 由 厂商 说 明 。 所 有 其 它 的 值 由 USB 说 明 保 
. u8 bmterfaceSubClass;/ 子 类 但 
. u8 bmterfaceProtocol:/ 协 议 码 
_u8 imterface;/ 描 述 此 接口 的 字 串 描述 符 的 索引 值 
) attribute _((packed)); 
/端点 描述 符 
struct usb endpoint descriptor { 
. u8 bLength;/ 此 描述 符 的 字 节 数 
. u8 bpDescriptorType;// 端 点 描述 符 类 
. u8 bEndpointAddress;/ 此 描述 符 所 描述 的 端点 的 地 址 
. u8 ”bmAttributes;// 此 域 的 值 描述 的 是 在 bConfigurationValue 域 所 指 的 配置 下 端点 的 特性 。 
Bit[1.0] 代 表 传送 类 型 : 00= 控 制 传送 ，01= 同 步 传送 ，10= 批 传送 ，11= 中 断 传 送 。 所 有 其 他 的 位 都 保留 
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. ul6 wMaxPacketSize;/ 当 前 配置 下 此 端点 能 够 接收 或 发 送 的 最 大 数据 包 的 大 小 
. u8 bnterval/ 轮 询 数 据 传送 端点 的 时 间 间 阶 
/以 下 用 于 声音 设备 端点 
. u8 bRefresh; 
. u8 bSynchAddress; 
) attribute — ((packed)); 


可 见 描述 符 中 包含 了 设备 类 型 与 协议 信息 ， 根 据 这 些 参数 ， 内 核 可 以 为 挂 载 上 的 USB 
设备 分 配合 适 的 设备 驱动 。USB 设备 驱动 程序 中 通常 使 用 usb device id 来 描述 所 支持 的 
USB 设备 的 功能 和 类 别 。 


struct usb device id { 


. ul6 match flags; 入 匹配 哪些 域 %/ 
PF] isses eH, 

. ul6 id Vendor; 

. ul6 idProduct; 

. ul6 bcdDevice 1o; 

. ul6 bcdDevice hi; 
PRECARI VU RO] 

. u$8 bDeviceClass; 

. u$8 bDeviceSubClass; 

. u$8 bDeviceProtocol; 

PELLI UO 

. u$8 bInterfaceClass; 

. u$8 bInterfaceSubClass; 

. u$8 bInterfaceProtocol; 

/*] TS REB REL USO 

. u$8 bInterfaceNumber; 

kernel ulong t driver info attribute  ((aligned(sizeof(kernel ulong t)))); 


14.4 S3C6410X USB 主机 控制 器 驱动 程序 


14.4.1 ”驱动 程序 原理 分 析 


S3C6410X 的 USB 控制 器 包含 2 个 USB 端口 ， 它 是 符合 OHCI 规范 的 USB 接口， 这 个 
USB 接口 的 寄存 器 是 与 OHCI1.0 规范 兼容 的 ， 而 Linux 内 核 完全 支持 OHCI1.0 规范 ， 所 以 
S3C6410X 的 主机 控制 器 驱动 要 实现 的 内 容 并 不 是 太 多 ， 主 要 是 实现 hc_driver 结构 接口 。 
S3C6410X 的 hc driver 结构 如 下 : 


static struct hc driver read mostly ohci s3c2410 hc driver; 
ohci s3c2410 hc driverhub status data = ohci s3c2410 hub status data; 
ohci s3c2410 hc driver.hub control = ohci s3c2410 hub control; 


S3C6410X USB 主机 控制 器 探测 函数 为 ohci hed s3c2410 drv_probe， 用 来 初始 化 
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S3C6410X USB 主机 控制 器 。 


static struct platform driver ohci hcd s3c2410 driver = ( 
.probe = ohci hcd s3c2410 drv probe, 
remove = ohci hcd s3c2410 drv remove, 


.Shutdown ^ — usb hcd platform shutdown, 
.driver ={ 

.name = "s3c2410-ohci", 

.pm =&ohci hcd s3c2410 pm ops, 


Hs 
h 
static int ohci hed s3c2410 drv probe(struct platform device *pdev) 
1 
return usb hcd s3c2410 probe(&ohci s3c2410 hc driver, pdev); 
} 
static int usb hcd s3c2410 probe(const struct hc driver *driver,struct platform device *dev) 
1 


struct usb hcd *hcd = NULL; 
struct s3c2410 hcd info *info = dev get platdata(&dev-^dev); 
int retval; 
S3c2410 usb set power(info, 1, 1); 
s3c2410 usb set power(info, 2, 1); 
hcd = usb create hcd(driver, &dev-»dev, "s3c24xx"); 
if (hcd — NULL) 
return -ENOMEM; 
hed->rsre start = dev-»resource[0].start; 
hcd->rsrc_len= resource size(&dev-»resource[0]); 
hcd->regs = devm ioremap resource(&dev-»dev, &dev->resource[0]);// 寄 存 器 映射 
if (IS ERR(hcd->regs)) { 
retval = PTR ERR(hcd->regs); 
goto err put; 
j 
clk = devm clk get(&dev--dev, "usb-host"); 
if(IS ERR(cIk)) { 
dev err(&dev--dev, "cannot get usb-host clock Wn"); 
retval = PTR ERR(cIk); 
goto err put; 
j 
usb clk = devm clk get(&dev-»dev, "usb-bus-host"); 
if(IS ERR(usb clk)) { 
dev err(&dev-»dev, "cannot get usb-bus-host clock Wn"); 
retval = PTR ERR(usb clk); 
goto err put; 
j 
s3c2410 start hc(dev, hcd); 
retval = usb add hcd(hed, dev-^resource[1].start, 0); 
if (retval != 0) 
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goto err ioremap; 


device wakeup_enable(hcd->selfcontrollen;/ 人 允许 此 设备 唤醒 系统 


return 0; 
err ioremap: 
s3c2410 stop hc(dev); 
err put: 
usb put hcd(hcd); 
return retval; 


14.4. S3C6410X 加 载 U AXI 


da) 首先 修改 /arch/arm/mach-s3c2410/mach-smdk2410.c， 添 加 USB 设备 : 


static struct platform device *smdk6410 devices[]  initdata = { 


#ifdef CONFIG SMDK6410 SD CHO 
&s3c device hsmmc0, 

#endif 

#ifdef CONFIG SMDK6410 SD CHI 
&s3c device hsmmcl, 

#endif 
&s3c device 12c0, 
&s3c device i2cl, 
&s3c device fb, 
&s3c device usb, 
&s3c device usb hsotg, 

#ifdef CONFIG REGULATOR 
&smdk6410 b pwr 5v, 

#endif 
&smdk6410 lcd powerdev, 
&smdk6410 smsc911x, 


j 
P 


(2) 运行 make menuconfig， 进 入 内 核 配置 ， 
如 图 14-4 Bron: 


I 


配置 


—- USB support 

pE d Support for Hozt-zside USB 
[*] USE announce new devices 
+ Miscellaneous USB options dk 


= 
+ 


er 


DT support 


USB Monitor 


内 Amm 


f 


USB 
Cypress COTxOO0 HOD support 
xHCI HCD (USB 3.0) support 
EHCI HCD (USB 2.0) support 
USB Mass Storage support 


dA AA A 


+ 
MEOE M 


图 14-4 USB support 配置 
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Enable USB persist by default 
ynamic USB minor allocation 


Rely on OTG and EH Targeted Peripherals List 
USB ULPI PHY interface support 


Support WUSB Cable Based Association (CBA) 
Host Controller Drivers #4 


L 


TE [device drivers] ^ [USB support] H 
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(3) AUR, DE U RAER U 盘 的 过 程 如 下 : 


局 动 后 插入 UU 盘 

[root@urbetter /dev]£ usb 1-1: USB disconnect, device number 2 

usb 1-1: new full-speed USB device number 7 using s3c2410-ohci 

usb 1-1: New USB device found, id Vendor-0781, idProduct-5575 
usb 1-1: New USB device strings: Mfr-1, Product-2, SerialNumber-3 
usb 1-1: Product: Cruzer Glide 

usb 1-1: Manufacturer: SanDisk 

usb 1-1: SerialNumber: 4C530201021202112304 

usb-storage 1-1:1.0: USB Mass Storage device detected 


scsi host1: usb-storage 1-1:1.0 

usb 1-2: new full-speed USB device number 8 using s3c2410-ohci 

usb 1-2: device descriptor read/64, error -62 

usb 1-2: device descriptor read/64, error -62 

usb 1-2: new full-speed USB device number 9 using s3c2410-ohci 

scsi 1:0:0:0: Direct-Access SanDisk Cruzer Glide 1.26 PQ: 0 ANSI: 6 

sd 1:0:0:0: Attached scsi generic sg0 type 0 

sd 1:0:0:0: [sdb] 15633408 512-byte logical blocks: (8.00 GB/7.45 GiB) 

sd 1:0:0:0: [sdb] Write Protect is off 

sd 1:0:0:0: [sdb] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA 
sdb: sdb1 

[root@urbetter /dev]# mount -t vfat /dev/sdbl /mnt/disk/ 

[root@urbetter /dev]# df 

Filesystem 1K-blocks Used Available Use% Mounted on 

192.168.10.102:/root/fgj/nfs/rootfs 29799484 7393104 20869612 26% / 

tmpfs 61948 0 61948 0% /dev/shm 

/dev/sdb1 7812864 16 7812848 096 /mnt/disk 

[root(Q)urbetter /dev|# cd /mnt/disk 

root@urbetter disk] ls 

root@urbetter disk] mkdir a 

root@urbetter disk | ls 


m dm ed 


& 


14.5 USB 键盘 设备 驱动 程序 分 析 


如 果 USB 主机 控制 器 已 经 开发 完毕 ， 那 么 剩 下 的 任务 就 是 开发 特定 的 USB 设备 驱动 程 
序 。 在 Linux 内 核 中 已 经 包含 一 些 通用 的 USB 设备 驱动 程序 如 键盘 、 鼠 标 、 声 卡 和 存储 设 
备 ， 这 里 以 USB 键盘 设备 为 例 分 析 USB 设备 驱动 程序 开发 的 方法 ,代码 在 
/drivers/hid/usbhid/usbkbd.c 中 。USB 键盘 设备 是 USB 设备 与 输入 设备 的 结合 体 。 


static struct usb device id usb kbd id table [] = { 
{ USB INTERFACE INFO(USB INTERFACE CLASS HID, USB INTERFACE SUBCLASS - 


BOOT, 
USB INTERFACE PROTOCOL KEYBOARD) }, 
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{ /*Terminating entry*/ 
h 
MODULE DEVICE TABLE (usb, usb kbd id table); 
static struct usb driver usb kbd driver = { 

.name — "usbkbd", 

.probe = usb kbd probe, 

disconnect = usb kbd disconnect, 

.jd table= ^ usb kbd id table, 
h 
module usb driver(usb kbd driver);/USB 设备 驱动 入 


民 据 usb kbd id table 可 知 本 USB 设备 驱动 文 持 HID 类 的 USB 设备 ,采用 键盘 协议 。 
USB 键盘 采用 中 断 传输 方式 接收 键盘 值 ， 采 用 控制 传输 方式 控制 键盘 LED AT. 
usb kbd probe 函数 设置 中 断 传输 参数 ， 并 注册 输入 子 设备 。 具 体 代码 如 下 : 


~ 


static int usb kbd probe(struct usb interface *iface,const struct usb device id *id) 
1 
struct usb device *dev — interface to usbdev(iface); 
struct usb host interface *interface; 
struct usb endpoint descriptor *endpoint; 
struct usb kbd *kbd; 
struct input. dev *input dev; 
int i, pipe, maxp; 
int error --ENOMEM; 
interface = iface-^cur altsetting; 
if (interface-^desc.bNumEndpoints != 1) 
return -ENODEV; 
endpoint = &interface-^endpoint[0].desc; 
if (Ilusb endpoint is int in(endpoint)) 
return -ENODEV; 
pipe = usb rcvintpipe(dev, endpoint-^bEndpointAddress); 
maxp = usb maxpacket(dev, pipe, usb pipeout(pipe)); 
kbd = kzalloc(sizeof(struct usb kbd), GFP KERNEL); 
input dev = input allocate device0:;/ 分 配 输入 设备 
if (!kbd || input. dev) 
goto faill; 
if(usb kbd alloc mem(dev, kbd)) 
goto fail2; 
kbd--usbdev = dev; 
kbd->dev = input dev; 
spin lock init(&kbd-^leds lock); 
if (dev-^ manufacturer) 
strlcpy(kbd-^name, dev-^manufacturer, sizeof(kbd-^name)); 
if (dev->product) { 
if (dev->manufacturer) 
strlcat(kbd->name, " ", sizeof(kbd->name)); 
strlcat(kbd->name, dev->product, sizeof(kbd->name)); 


376 


第 143: USB 驱动 程序 


} 
if (!strlen(kbd->name)) 
snprintf(kbd->name, sizeof(kbd->name), 
"USB HIDBP Keyboard %04x:%04x", 
lel6 to cpu(dev->descriptor.idVendor), 
le16 to cpu(dev->descriptor.idProduct)); 
usb make path(dev, kbd->phys, sizeof(kbd->phys)); 
strlcat(kbd->phys, Vinput0", sizeof(kbd->phys)); 
/填充 输入 设备 
input dev->name = kbd->name; 
input dev->phys = kbd->phys; 
usb to input id(dev, &input dev->id); 
input dev-^dev.parent = &iface-^dev; 
input set drvdata(input dev, kbd); 
input dev-»evbit[0] = BIT MASK(EV KEY)|BIT MASK(EV LED)|BIT MASK(EV REP); 
input dev-^ledbit[0] = BIT MASK(LED NUML)| BIT MASK(LED CAPSL)| 
BIT MASK(LED SCROLLL) | BIT MASK(LED COMPOSE) | 
BIT MASK(LED KANA); 
for (i = 0; i < 255; i++) 
set bit(usb kbd keycode[i], input dev->keybit); 
clear bit(0, input dev->keybit); 
input dev-^event = usb kbd event;//led 事件 处 理 函 数 
input dev-^open = usb kbd open; 


input dev->close — usb kbd close; 
usb fill int urb(kbd-^irq, dev, pipe,kbd->new, (maxp > 8 ? 8 : maxp), 
usb kbd irq, kbd, endpoint->bInterval);// 填 充 键盘 按 刍 中断 urb 
kbd->irq->transfer dma = kbd->new_dma; 
kbd->irq->transfer flags|= URB NO TRANSFER DMA MAP; 
kbd->cr->bRequestType = USB TYPE CLASS|USB RECIP INTERFACE; 
kbd->cr->bRequest = 0x09; 
kbd->cr->wValue = cpu to 1e16(0x200); 
kbd->cr->wIndex = cpu to lel6(interface-^desc.bInterfaceNumber); 
kbd->cr->wLength = cpu to le16(1); 
usb fill control urb(kbd--led, dev, usb sndctrlpipe(dev, 0), 
(void *) kbd-»cr, kbd->leds, l,usb kbd led, kbd);/2& led 控制 urb 
kbd->led->transfer dma = kbd->leds dma; 
kbd->led->transfer flags |= URB NO TRANSFER DMA MAP; 
error = input register_device(kbd->dev);// 注 册 输入 设备 
if (error) 
goto fail2; 
usb set intfdata(1face, kbd); 
device set wakeup enable(&dev-»dev, 1);// 允 许 此 设备 唤醒 系统 
return 0; 
fail2: 
usb kbd free mem(dev kbd); 
faill: 
input free device(input dev); 
kfree(kbd); 
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return error; 


) 
usb kbd open 函数 中 提交 了 USB 请 求 块 ， 代 码 如 下 : 


static int usb kbd open(struct input dev *dev) 


{ 
struct usb kbd *kbd = input get drvdata(dev); 
kbd->irq->dev = kbd--usbdev; 
if(usb submit urb(kbd->irq, GFP KERNEL)) 
return -EIO; 
return 0; 
} 


L 


在 USB 键盘 完成 数据 接收 后 会 产生 中 断 ， 键 盘 数据 存放 在 kbd-new Ho "P ETARTE pK ži 
usb kbd irq 代码 如 下 : 


static void usb kbd irq(struct urb *urb) 


{ 
struct usb kbd *kbd = urb->context; 
int i; 
switch (urb-^status) { 
case 0:/* 成 功 */ 
break; 
case -ECONNRESET: PERR 


case -ENOENT:// 文 件 不 存在 
case -ESHUTDOWN: 传 输 端 点 关闭 ， 无 法 传输 
return; 
default:* 其 他 错误 */ 
goto resubmit; 


} 
for (i = 0; i < 8;1++) 
input_report_key(kbd->dev, usb kbd keycode[i+ 224], (kbd->new[0] >> i) & 1); 
for i =2;i< 8; it+) ( 
if (kbd->old[i] > 3 && memscan(kbd->new + 2, kbd->old[il, 6) == kbd->new + 8) { 
if (usb_kbd_keycode[kbd->old[i]]) 
input_report_key(kbd->dev, usb_kbd_keycode[kbd->old[i]], 0); 


else 
hid info(urb-^dev," Unknown key (scancode %#x) released.\n",kbd->old[i]); 
} 
if (kbd->newl[i] > 3 && memscan(kbd->old + 2, kbd->new[il, 6) == kbd->old + 8) { 
if(usb kbd keycode[kbd-^new[1]]) 
input report key(kbd->dev, usb kbd keycode[kbd--^new[i]], 1); 
else 
hid info(urb-^dev,"Unknown key (scancode %#x) pressed. n",kbd-^new[i]); 
} 
} 
input sync(kbd->dev);/ 同 步 键盘 的 输入 消息 
memcpy(kbd->old, kbd->new, 8); 
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resubmit: 
i= usb submit urb (urb, GFP ATOMIC); 
if (i) 
hid err(urb-^dev, "can't resubmit intr, Vos-Pos/inputO, status %d", 
kbd--usbdev-^bus--bus name,kbd--usbdev--devpath, i); 
} 


usb kbd close 函数 代码 如 下 ; 


static void usb kbd close(struct input dev *dev) 


1 
struct usb kbd *kbd — input get drvdata(dev); 
usb kill urb(kbd-^irq); 

} 


usb kbd event P UT oe dz rb 


键盘 上 的 LED 灯 。 


一 


static int usb kbd event(struct input dev *dev, unsigned int type,unsigned int code, int value) 
1 
unsigned long flags; 
struct usb kbd *kbd — input get drvdata(dev); 
if (type != EV LED)return -1; 
spin lock irqsave(&kbd--leds lock, flags); 
kbd-^newleds = (!!test bit(LED KANA, dev--led) << 3) | 
(ltest bit(LED COMPOSE, dev->led) << 3) | 
(I!test bit(LED SCROLLL, dev--led) << 2) | 
(I!test bit(LED CAPSL, dev--led) << 1) | 
(!!test bit(LED NUML, dev->led)); 
if (kbd->led urb submitted) 
spin unlock irqrestore(&kbd-^leds lock, flags); 
return 0; 
} 
if (*(kbd->leds) == kbd->newleds){ 
spin unlock irqrestore(&kbd->leds lock, flags); 
return 0; 
} 
*(kbd->leds) = kbd->newleds; 
kbd->led->dev = kbd->usbdev; 
if (usb submit urb(kbd--led, GFP ATOMIC))/ 提 交 led 控制 urb， 数 据 在 kbd->leds 中 
pr err("usb submit urb(leds) failed n"); 
else 
kbd->led urb submitted = true; 
spin unlock irqrestore(&kbd-^leds lock, flags); 
return 0; 


j 
关于 标准 键盘 LED 的 控制 ， 可 参见 第 10 章 。 


Tar 
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POR DERE PEI Y: 


音频 驱动 是 Linux 内 核 中 比较 特殊 的 驱动 ， 它 的 代码 没有 放 到 /drivers 下 ， 而 是 放 到 


/sound Hæ Fo HAT Linux 内 核 的 音频 驱动 主要 采用 ALSA (Advanced Linux Sound 


Architecture) 架构 。 本 章 介 绍 ALSA 


15.1 ALSA 音频 体系 


架构 与 音频 驱动 程序 开发 。 


ALSA 音频 体系 不 仅 提供 了 内 核 驱 动 模块 ， 还 专门 为 应 用 程序 的 编写 提供 了 方便 的 函数 
Æ (alsalib)。ALSA 音频 体系 的 总 体 架 构 如 图 15-1 所 示 。 


系统 亩 


ALSA core 


ALSA SOC 


图 


ALSA 音频 体系 有 如 下 特点 : 


15-1 ALSA 总 体 架 构 


(1) 支持 所 有 类 型 的 音频 接口 ， 从 普通 的 声卡 到 专业 的 音频 设备 。 


(2) 完全 模块 化 的 声卡 驱动 程序 。 


(3) SMP 和 线程 安全 的 设计 。 


(4) 一 个 用 户 空间 的 函数 库 ， 提 供 了 高 层次 的 编程 接口 ， 从 而 简化 了 应 用 程序 的 


(5) 支持 较 老 的 OSS API， 兼 容 大 多 数 OSS 应 用 程序 。 


ALSA 音频 体系 为 应 用 层 提供 了 七 种 接口 : (1) 设备 信息 接口 (/proc/asound); (2) 设备 
控制 接口 Vdev/snd/controlCX); (3) 混 音 器 设备 接口 (/dev/snd/mixerCXDX); (4) PCM 设备 


接口 (dev/snd/pcmCXDX); (5) 原始 MIDI 设备 接口 /dev/snd/midiCXDX); (6) 声音 合成 设 


备 接口 (/dev/snd/seq); (7) 定时 器 接口 


(/dev/snd/timer). 


15.2 ALSA 核心 层 


15.2.1 声卡 


"E 


] snd card 结构 描述 : 

struct snd card { 
int number; 
char id[16]; 
char driver[16]; 
char shortname[32 |; 
char longname[80]; 
char irq. descr[32]; 


js 


char mixername[80]; 
char components[128 ]; 
struct module *module; 
void *private data; 


void (*private free) (struct snd card *card); /* 释 放 私 有 数据 的 回 |i 


struct list head devices; 
struct device ctl dev; 


unsigned int last numid; 


struct rw semaphore controls_rwsem;/* 控 制 接口 


rwlock tctl files rwlock; 


int controls count; 
int user ctl count; 
struct list head controls; 
struct list head ctl files; 


struct mutex user ctl lock; 
struct snd info entry *proc root; 


$153 
[* 8 Ej */ 
居 声 卡 ID*/ 
[UJ] AA I 
/# 声 卡 短 名 并 
AE RAT 
/* 中 Wr */ 
/# 混 音 器 名 头 
PE Ee] 
FALA td 
调 */ 
PC eden] 
Pn nl 
链表 锁 */ 
诺 控 制 接口 文件 链表 锁 */ 
/#* 所 有 控制 接口 的 数量 次 
必用 户 控 制 接口 数量 */ 
rese Laden 
PRSE SEE E CES 
* Ri P deg Dee 
/*proc 根 目 录 */ 


struct snd info entry *proc id; 


struct proc dir entry *proc root link; 
/# 关 联 此 声卡 的 文件 链表 六 

struct snd shutdown f ops *s f ops; /* 停 止 状 态 下 的 文件 操作 */ 
谨 声 卡 文件 锁 */ 


struct list head files list; 


spinlock t files lock; 
int shutdown; 


放声 长] 


EAE BIS 


struct completion *release completion; 


AE RRK A */ 


struct device *dev; 
struct device card dev; 


const struct attribute group *dev groups[4]; /* 属 性 组 */ 
/*card dev 是 否 注 册 */ 


bool registered; 


初始 化 一 个 声卡 结构 : 


int snd card new(struct device *parent, int idx, const char *xid, 


struct module *module, int extra size,struct snd card **card ret); 


音频 设备 驱动 程序 
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snd card register 函数 用 来 注册 声卡 : 


int snd_card register (struct snd card * card); 


15.2.2. ”音频 设备 
一 个 声卡 可 能 包含 多 个 音频 设备 : 


struct snd device ( 


struct list head list; PHEJIE BA EEUU 8e */ 
struct snd card *card; / E 的 声卡 */ 


enum snd device state state; /* 设 备 状态 

enum snd device typetype; 作 设 备 类 型 p 
void *device data; PE o 
struct snd device ops *ops; /*?i d PRTES/ 


js 


音频 设备 包括 PCM 实例 、 控 制 接口 、 原 始 MIDI 接口 等 类 型 。 音 频 设备 的 类 型 是 enum 
snd device type: 


enum snd device type ( 

SNDRV DEV LOWLEVEL, 
NDRV DEV CONTROL, 
NDRV DEV INFO, 

NDRV DEV BUS, 
NDRV DEV CODEC, 
DRV DEV PCM, 

DRV DEV COMPRESS, 
DRV DEV RAWMIDI, 
NDRV DEV TIMER, 

DRV DEV SEQUENCER, 
NDRV DEV HWDEP, 

NDRV DEV JACK, 


ZEZE 


Ez 


S 
S 
S 
S 
S 
S 
S 
S 
S 
S 
S 


js 
snd device new 函数 为 声卡 创建 一 个 音频 设备 : 


int snd device new(struct snd card *card, snd device type t type, 
void *device data, struct snd device ops *ops) 


snd device free 函数 从 声卡 中 删除 音频 设备 : 


int snd device free(struct snd card *card, void *device data); 
15.2.3 PCM 


PCM 全 称 为 脉冲 编码 调制 (pulse-code modulation )， 在 音频 处 理 里 面 就 是 对 模拟 音频 进 
行 脉 冲 采样 。 声 卡 对 模拟 音频 信号 按照 一 定 的 采样 率 (sample rate) 以 及 精度 (bits per 
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sample) 进行 采样 ， 每 个 采样 点 的 音频 数据 为 一 帧 (frame )。 一 帧 音频 数据 的 bit 数 为 精度 Xx 
声 道 ， 一 秒 音频 数据 的 bit 数 为 精度 X 声 道 X 采 样 率 。 一 帧 一 帧 的 音频 数据 按照 时 间 顺 序 上 
在 一 起 组 成 了 音频 流 。PCM 数据 实际 就 是 原始 的 音频 流 数据 。 

ALSA 架构 中 ，PCM 用 来 管理 音频 流 ， 它 用 snd pem 结构 描述 。 一 个 声卡 可 以 包含 多 
个 PCM， 每 个 PCM 又 包含 多 个 播放 或 采集 子 流 。 图 15-2 为 ALSA PCM 流 的 架构 。 


Ud 


Snd card 


Playback stream Capture stream 


图 15-2 音频 流 组 织 结构 


struct snd pcm { 
struct snd card *card;// 所 属 声卡 
struct list head list; 
int device; /* Ux 4& 5 */ 
unsigned int info flags; 


unsigned short dev class; 

unsigned short dev subclass; 

char id[64]; 

char name[80]; 

struct snd pcm str streams[2];// 子 流 
struct mutex open mutex; 

wait queue head topen wait; 


void *private data; 

void (*private free) (struct snd pcm *pcm); 

bool internal; /* 4 ffi 4 A ipf */ 

bool nonatomic; /* 是 和 否 整 个 PCM 操作 均 处 于 非 原 子 上 下 文 */ 


je 
音频 流 包 括 播放 流 与 采集 流 ， 播 放流 与 采集 流 均 有 多 个 子 流 ， 分 别 存放 在 snd_pcm 结构 
的 streams[2] 成 员 中 。 音 频 流 的 方向 定义 如 下 ; 


enum { 
SNDRV PCM STREAM PLAYBACK = 0, 
SNDRV PCM STREAM CAPTURE, 
SNDRV PCM STREAM LAST = SNDRV PCM STREAM CAPTURE, 
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PCM 音频 子 流 结构 如 下 : 


struct snd pcm substream { 
struct snd pcm *pcm; 
struct snd pcm str *pstr; 


void *private data;/* 复 制 自 pcm->private_ data*/ 
int number; 

char name[32]; IY ALAS 

int stream; P*-Y 3n Jy [8] */ 


struct pm qos request latency pm qos req; 
size t buffer bytes max; /环形 缓冲 大 小 并 
struct snd dma buffer dma buffer;//DMA 缓冲 
size tdma max;//DMA 大 小 

const struct snd pcm ops *ops;//PCM 操作 


struct snd pcm runtime *runtime;// 运 行 时 信息 
struct snd timer *timer; 上 定时 器 各 
unsigned timer running: 1; 举 定 时 需 是 否 在 运行 六 
struct snd pcm substream *next;// 指 向 下 一 个 子 流 
struct list head link list; 

struct snd pcm group self group; 


struct snd pcm group *group; 


} 
snd_pcm_new 函数 创建 一 个 新 的 PCM 实例 : 


int snd pcm new(struct snd card *card, char *id, int device, 
int playback count, int capture count,struct snd pcm ** rpcm); 


snd pcm new stream 函数 创建 一 个 新 的 PCM 子 流 : 
int snd pcm new stream(struct snd pcm *pcm, int stream, int substream count) 
stream 即 子 流 的 方向 。 
15.2.4 ”音频 控制 接口 
音频 控制 接口 定义 如 下 : 


struct snd kcontrol new { 
snd ctl elem iface tiface; ”/* 接 口 标 误 */ 
unsigned int device;/* 设 备 /客户 号 */ 
unsigned int subdevice;/* 子 设备 / 子 流 号 */ 
const unsigned char *name; /*ASCII 名 */ 
unsigned int index; ” /* 系 数 */ 
unsigned int access; /* 访 问 权 限 */ 
unsigned int count; 
snd kcontrol info t*info;// 接 口 的 相关 信息 
snd kcontrol get t *get;// 获 取 函 数 
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snd kcontrol put t *put;// 设 置 函 数 
union { 
snd kcontrol tlv rw t *c; 
const unsigned int *p; 
} tlv; 
unsigned long private value; 


B 
snd ctl newl 函数 创建 一 个 新 的 控制 接口 : 


struct snd kcontrol * snd ctl newl (const struct snd kcontrol new * ncontrol,void * private data); 


snd ctl free one 函数 释放 一 个 控制 接 


void snd ctl free one (struct snd kcontrol * kcontrol); 


snd ctl add 函数 为 声卡 添加 一 个 控制 接 


int snd ctl add (struct snd card * card, struct snd kcontrol * kcontrol); 


snd ctl remove 函数 从 声卡 删除 一 个 控制 接口 ; 


int snd ctl remove(struct snd card *card, struct snd kcontrol *kcontrol) ; 


下 面 是 CS4281 芯片 的 “音频 播放 音量 ”控制 接 


static struct snd kcontrol new snd cs4281 pcm vol = 


{ 


.iface = SNDRV CTL ELEM IFACE MIXER, 
.name = "PCM Stream Playback Volume", 
info = snd cs4281 info volume, 


.get= snd cs4281 get volume, 
.put = snd cs4281 put volume, 
private value = ((BAO PPLVC << 16)| BAO PPRVC), 
«tlv = { .p= db scale dsp j, 
h 
snd ctl add(card, snd ctl newl(&snd cs4281 pcm vol, chip));// 将 struct cs4281 *chip 作为 私有 数据 
/接口 函数 定义 
#define snd kcontrol chip(kcontrol) ((kcontrol)->private data) 
static int snd cs4281 get volume(struct snd kcontrol *kcontrol,struct snd ctl elem value *ucontrol) 


1 


struct cs4281 *chip = snd kcontrol chip(kcontrol); 

int regL = (kcontrol-^private value >> 16) & Oxffff, 

int regR = kcontrol-^private value & Oxffff, 

int volL, volR; 

volL = CS VOL MASK - (snd cs4281 peekBAO(chip, regL) & CS VOL MASK); 
volR = CS VOL MASK - (snd cs4281 peekBAO(chip, regR) & CS VOL MASK); 
ucontrol-7value.integer.value[0] = volL; 

ucontrol-^value.integer.value[1] = volR; 
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return 0; 
j 
static int snd cs4281 put volume(struct snd kcontrol *kcontrol,struct snd ctl elem value *ucontrol) 
1 


struct cs4281 *chip = snd kcontrol chip(kcontrol); 
int change — 0; 
int regL = (kcontrol-^private value >> 16) & Oxffff, 
int regR = kcontrol-^private value & Oxffff, 
int volL, volR; 
volL = CS VOL MASK - (snd cs4281 peekBAO(chip, regL) & CS VOL MASK); 
volR = CS VOL MASK - (snd cs4281 peekBAO(chip, regR) & CS VOL MASK); 
if (ucontrol-^value.integer.value[0] != volL) {V/ 如 果 设 置 值 与 寄存 器 值 不 一 致 
volL = CS VOL MASK - (ucontrol->value.integer.value[0] & CS VOL MASK); 
snd cs4281 pokeBAO(chip, regL, volL); 
change = 1; 


j 

if (ucontrol-»value.integer.value[1] != voIR) {/ 如 果 设 置 值 与 寄存 器 值 不 一 致 
volR = CS VOL MASK - (ucontrol-^value.integer.value[1] & CS VOL MASK); 
snd cs4281 pokeBAO(chip, regR, volR); 
change = 1; 


j 


return change; 


} 
在 shell 中 可 以 通过 amixer 命令 设置 CS4281 的 音量 ， 例 如 : 


amixer cset name= PCM Stream Playback Volume ' 26,26 
内 核定 义 了 一 系列 宏 来 组 装 snd. kcontrol new: 


#define SOC SINGLE(xname, reg, shift, max, invert) ^ 
{ .iface = SNDRV CTL ELEM IFACE MIXER, .name = xname, V 
info = snd soc info volsw, .get = snd soc get volsw,\ 


.put = snd soc put volsw, \ 
private value = SOC SINGLE VALUE(reg, shift, max, invert, 0) } 
#define SOC DOUBLE(xname, reg, shift left, shift right, max, invert) \ 
{ .iface = SNDRV CTL ELEM IFACE MIXER, .name = (xname),\ 
info —snd soc info volsw, .get= snd soc get volsw,\ 


.put= snd soc put volsw, \ 
.private value = SOC DOUBLE VALUE( 


例如 WM9713 的 kcontrol 接口 定义 : 


static const struct snd kcontrol new wm9713 snd ac97 controls[] = { 

SOC DOUBLE TLV('Speaker Playback Volume", AC97 MASTER, 8, 0, 31, 1, out tlv), 

SOC DOUBLE('Speaker Playback Switch", AC97 MASTER, 15, 7, 1, 1), 

SOC DOUBLE TLV("Headphone Playback Volume", AC97 HEADPHONE, 8, 0, 31, 1,out tlv), 
SOC DOUBLE("Headphone Playback Switch", AC97 HEADPHONE, 15, 7, 1, 1), 
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SOC DOUBLE TLV("Line In Volume", AC97 PC BEEP, 8, 0, 31, 1, main tlv), 

SOC DOUBLE TLV("PCM Playback Volume", AC97 PHONE, 8, 0, 31, 1, main tlv), 
SOC SINGLE TLV("Mic 1 Volume", AC97 MIC, 8,31, 1, main tlv), 

SOC SINGLE TLV("Mic 2 Volume", AC97 MIC, 0,31, 1, main tlv), 

SOC SINGLE TLV("Mic 1 Preamp Volume", AC97 3D CONTROL, 10, 3, 0, mic tlv), 
SOC SINGLE TLV("Mic 2 Preamp Volume", AC97 3D CONTROL, 12, 3, 0, mic tlv), 
SOC SINGLE("Mic Boost (420dB) Switch", AC97 LINE, 5, 1, 0), 

SOC SINGLE("Mic Headphone Mixer Volume", AC97 LINE, 0, 7, 1), 


5 
查看 内 核 中 所 有 的 kcontrols 命令 如 下 : 


[root@urbetter home]# ./amixer controls 


numid=1,iface=MIXER,name='Speaker Playback Volume' 
numid-2,iface-MIXER,name-' Speaker Playback Switch' 
numid-3,iface-MIXER,;name- Headphone Playback Volume' 


15.2.25 AC97 声卡 


AC97 全 称 Audio CODEC 97, Æ Intel 等 几 家 业界 巨头 制定 的 多 媒体 声卡 规范 。 
AC97 标准 作为 一 种 全 新 的 音源 架构 ， 主 要 就 是 针对 PC 多 媒体 市 场 需求 日 益 人 迫切 的 音源 
言 号 处 理 方式 和 音源 硬件 加 速 方式 两 个 方面 进行 强化 ， 并 据 此 提出 了 一 种 切实 可 行 的 解 


" 


struct snd ac97 { 
const struct snd ac97 build ops *build ops; 
void *private data; 
void (*private free) (struct snd ac97 *ac97); 
struct snd ac97 bus *bus; 
struct pci dev *pci; /*PCI 设备 */ 
struct snd info entry "proc; 
struct snd info entry *proc regs; 
unsigned short subsystem vendor; 
unsigned short subsystem device; 
struct mutex reg mutex; 
struct mutex page mutex; 
unsigned short num; /*codec 号 : 0 = 主 ,1= 第 二 */ 
unsigned short addr; /*codec 物理 地 址 */ 
unsigned int id; /*codec ID*/ 


unsigned short caps; /* 能 力 (register 0)*/ 

unsigned short ext. id;/* 扩 展 特性 识别 (register 28)*/ 
unsigned short ext mid; /*} fé modem ID (register 3C)*/ 
const struct snd ac97 res table *res table; 
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unsigned int scaps; —/*JKJJff& 7] */ 
unsigned int flags; 。 /* 特 殊 人 码 */ 


unsigned int rates[6]; /* 见 AC97 RATES * 定义 */ 


unsigned int spdif status; 
unsigned short regs[0x80]; /* 寄 存 器 cache*/ 


h 
struct snd ac97 bus ( 
struct snd ac97 bus ops "ops; 
void *private data; 
void (*private free) (struct snd ac97 bus *bus); 
struct snd card *card; 
unsigned short num; /* M2 5 */ 
unsigned short no vra: 1, /* 不 支持 VRA*/ 
dra: 1, /* SFERU EK */ 
isdin: 1;/* 非 独立 SDIN*/ 
unsigned int clock; /*AC'97 基 时 钟 (通常 为 48 


000Hz)*/ 


spinlock tbus lock; ARM, EHF slot 分 配 */ 
unsigned short used slots[2][4]; /* S PREH ÉI PCM slot*/ 


unsigned short pcms count; /*PCM 数量 */ 
struct ac97 pcm *pcms; 
struct snd ac97 *codec[4]; 
struct snd info entry *proc; 
h 


AC97 声卡 遵循 统一 的 规范 ， 有 一 样 的 寄存 器 。 内 核 ! 


访问 AC97 寄存 器 的 接口 函数 如 下 : 


snd ac97 write 函数 写 AC97 寄存 器 : 


void snd ac97 write(struct snd ac97 *ac97, unsigned short reg, unsigned short value); 


snd ac97 read 函数 读 AC97 寄存 器 : 


unsigned short snd ac97 read(struct snd ac97 *ac97, unsigned short reg); 


snd ac97 update 函数 更 新 ACO 寄存 器 : 


int snd ac97 update(struct snd ac97 *ac97, unsigned short reg, unsigned short value); 


snd ac97 update 会 比较 寄存 器 中 的 旧 值 ， 如 果 旧 值 与 value 不 一 致 则 更 新 寄存 器 。 


15.3 ALSA SOC 架构 


ALSA SOC 层 可 为 SOC 嵌入 式 处 理 器 和 便携 音 
ALSA SOC 层 使 得 平台 驱动 、CPU 驱动 与 音频 编码 器 


频 编码 器 提供 更 好 的 ALSA 支持 。 
驱动 分 离 ， 代 码 的 可 重用 性 更 好 。 另 


H 


外 ， 它 提供 了 标准 的 音频 事件 〈 如 耳机 插 拔 ) 的 处 理 接口 、 电 源 控制 接口 。 图 15-3 为 ALSA 


SOC 架构 图 。 
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Machine Driver 


Codec Driver 负责 计算 机 特有 的 控制 与 事件 处 理 Platform Driver 
负责 Codec 与 Platform 之 间 的 耦合 


控制 接 数据 传输 
IC 等 DS PCM AC97 


Audio Codec 
Kl 15-3 ALSA SOC 架构 


15.3.1 SOC 声卡 
SOC 声卡 用 snd soc card 结构 描述 : 


struct snd soc card { 
const char *name; 
const char *long name; 
const char *driver name; 
struct device *dev; 
struct snd card *snd card; 
struct module *owner; 
Struct mutex mutex; 
struct mutex dapm mutex; 
bool instantiated; 
int (*probe)(struct snd soc card *card); 
int (*late probe)(struct snd soc card *card); 
int (*remove)(struct snd soc card *card); 
int (*suspend pre)(struct snd soc card *card); 
int (*suspend post)(struct snd soc card *card); 
int (*resume pre)(struct snd soc card *card); 
int (*resume post)(struct snd soc card *card); 
/* [ys 
int (*set bias level)(struct snd soc card *,struct snd soc dapm context *dapm, 


enum snd soc bias level level); 
int (*set bias level post)(struct snd soc card *,struct snd soc dapm context *dapm, 
enum snd soc bias level level); 
int(*add dai link)(struct snd soc card *,struct snd soc dai link *link); 
void (*remove dai link)(struct snd soc card *,struct snd soc dai link *link); 
long pmdown time; 
/*CPU <--> Codec DAI links */ 
struct snd soc dai link *dai link; ”/* 预 定义 的 link*/ 
int num links; ”人 * 预 定义 的 link 数量 */ 
struct list head dai link list; /* 所 有 link*/ 
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js 


int num dai links; 
struct list head rtd list; 


int num rtd; 


/DAMP 相关 的 成 员 
const struct snd soc dapm widget *dapm widgets; 
int num dapm widgets; 
const struct snd soc dapm route *dapm routes; 
int num dapm routes; 
const struct snd soc dapm widget *of dapm widgets; 
int num of dapm widgets; 
const struct snd soc dapm route *of dapm routes; 


int num of dapm routes; 
bool fully routed; 


snd soc card 可 以 看 作 是 继承 于 snd card 结构 。snd soc dai link 结构 定义 了 SOC 声卡 
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连接 的 数字 音频 接口 。snd_soc_card 的 dai link 成 员 仅 用 于 初始 化 。 


struct snd soc dai link ( 


/* VTE machine driver 中 设置 */ 


const char *name; /*Codec 名 称 */ 
const char *stream name; [if e CSI 
/CPU 侧 


const char *cpu name; 

struct device node *cpu of node; 

const char *cpu dai name; 

/编码 器 侧 

const char *codec name; 

struct device node *codec of node; 

const char *codec dai name; 

struct snd soc dai link component *codecs; 

unsigned int num codecs; 

/平台 侧 

const char *platform name; 

struct device node *platform of node; 

int be 1d; 

const struct snd soc pcm stream *params; 

unsigned int num params; 

unsigned int dai fmt; "JA I TEC 

enum snd soc dpem trigger trigger[2]; /*DPCM 触发 类 型 */ 
int (*init)(struct snd soc pcm runtime *rtd); /*codec/machine 特有 的 初始 化 */ 
int(*be hw params fixup)(struct snd soc pcm runtime *rtd,struct snd pcm hw params *params); 
/*machine 流 操 作 */ 

const struct snd soc ops *ops; 


const struct snd soc compr ops *compr ops; 
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人/# 单 向 dai links 标志 */ 
bool playback only; 
bool capture only; 

姑 非 原子 操作 标志 六 


bool nonatomic; 


1 


js 
Machine 层 一 般 会 注册 一 个 soc-audio 平台 设备 。 而 soc-audio 对 应 的 平台 驱动 则 是 在 
ALSA 核心 层 实现 的 (soc-core.c)。 


static struct platform driver soc driver= { 


.driver ={ 
.name = "soc-audio", 
.pm = &snd soc pm ops, 
j 5 
.probe — soc probe, 
remove — soc remove, 
je 
static int initsnd soc init(void) 
{ 
snd soc debugfs init(); 
snd soc util init(); 
return platform driver register(&soc driver); 
j 


soc probe PAZILSEEILAI F: 
static int soc probe(struct platform device *pdev) 


1 
struct snd soc card *card — platform get drvdata(pdev); 
if (!card)return -EINVAL; 
dev warn(&pdev-»dev," ASoC: machine %s should use snd soc register card()n",card-^»name); 
card->dev = &pdev-»dev; 
return snd soc register card(card); 
} 
int snd soc register card(struct snd soc card *card) 
{ 


int 1, ret; 
struct snd soc pcm runtime *rtd; 
if (!Icard-^name || !card-7dev) 
return -EINVAL; 
for (i = 0; i < card-^num links; i+) { 
struct snd soc dai link *link = &card-^dai link[i]; 
ret —soc init dai link(card, link);// 检 查 link 参数 是 否 正 确 
if (ret) { 
dev err(card-^»dev, "ASoC: failed to init link Vos Wn", 
link->name); 


return ret; 
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snd soc instantiate card 会 把 对 SOC 
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j 

dev_set_drvdata(card->dev, card); 

snd soc initialize card lists(card); 

INIT LIST HEAD(&card-^dai link list); 
card-^num dai links = 0; 

INIT LIST HEAD(&card-^rtd list); 
card->num rtd = 0; 

INIT_LIST HEAD(&card->dapm dirty); 
INIT LIST HEAD(&card-^dobj list); 


card--instantiated = 0; 


mutex init(&card-^mutex); 

mutex init(&card-^dapm mutex); 

ret = snd soc instantiate card(card); 
if (ret != 0) 


return ret; 


return ret; 


函数 )， 并 调 
15.3.2 DAI 


DAI 是 数字 音 
DAI。 每 个 DAI 有 自 


Struct 
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snd soc dai { 

const char *name; 

int id; 

struct device *dev;// 关 联 的 设备 

struct snd soc dai driver *driver;//DAI 驱动 
PDAL 运行 时 信息 */ 


unsigned int capture active:1;/* 采 集 流 是 否 在 用 */ 


频 接 口 (Digital Audio Interface)。 处 理 器 与 音频 编码 器 均 有 
己 的 DAI 驱动 (snd_soc dai driver). 


unsigned int playback active:1;/# 播 放流 是 和 否 在 用 


unsigned int symmetric rates:1; 

unsigned int symmetric channels:1; 

unsigned int symmetric samplebits:1; 

unsigned int active; 

unsigned char probed:1; 

struct snd soc dapm widget *playback widget; 
struct snd soc dapm widget *capture widget; 
/*DAIDMA 参数 */ 

void *playback dma data; 

void *capture dma data; 


层 的 组 件 进 行 绑 定 〈 见 15.3.5 节 的 soc bind dai link 
] snd card new 创建 一 个 声卡 (snd_card)， 最 后 调用 snd card register 注册 一 个 


个 或 多 个 


* 


unsigned int rate; 
unsigned int channels; 


unsigned int sample bits; 


h 

struct snd soc dai driver { 
/DAI 描述 */ 
const char *name; 
unsigned int id; 
unsigned int base; 
struct snd soc dobj dobj; 


/*DAI 驱动 回调 */ 
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int (*probe)(struct snd soc dai *dai); 

int (*remove)(struct snd soc dai *dai); 
int (*suspend)(struct snd soc dai *dai); 
int (*resume)(struct snd soc dai *dai); 


int (*compress new)(struct snd soc pcm runtime *rtd, int num); 
bool bus_control;/ 是 否 用 于 控制 总 线 
const struct snd soc dai ops *ops; 


/*DAI 能 力 */ 


struct snd soc pcm stream capture; 


struct snd soc pcm stream playback; 


unsigned int symmetric rates: 


l; 


unsigned int symmetric channels:1; 


unsigned int symmetric samp 


lebits:1; 


族 探 测 与 删除 顺序 ， 用 于 相互 依赖 的 组 件 */ 


int probe order; 
int remove order; 


js 


内 核 中 所 有 的 snd soc dai driver 
snd soc component 链表 中 : 


都 将 附着 到 struct snd soc component 中 ， 最 终 保 存在 


static LIST HEAD(component list); 


15.3.3 codec 


E 


struct snd soc codec ( 
struct device *dev; 


音频 编码 器 使 用 snd soc codec 结构 描述 : 


const struct snd soc codec driver *driver; 


struct list head list; 
struct list head card list; 
[XS 4T WI */ 


unsigned int cache bypass:1; /* 禁 止 访问 cache*/ 


unsigned int suspended:1; /*# 


E 起 状态 */ 


unsigned int cache init:1; /*codec cache 是 否 初始 化 */ 
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/*codec IO*/ 
void *control data; /# 控 制 数 据 闷 
hw write t hw write; 


void *reg cache; 
28 
struct snd soc component component; 


js 


snd soc register codec 函数 注册 一 个 soc codec: 


int snd soc register codec(struct device *dev,const struct snd soc codec driver *codec drv, 
struct snd soc dai driver *dai drv,int num dai) 


所 有 的 snd soc codec 将 被 添加 到 codec 链表 中 : 


static LIST HEAD(codec list); 


15.3.44 SOC 平台 
SOC 平台 使 用 snd_soc_platform 结构 折 


struct snd soc platform { 
const char *name; 
int id; 
struct device *dev; 
struct snd soc platform driver *driver; 
unsigned int suspended:1; /* 挂 起 标志 */ 
unsigned int probed:1; 


struct snd soc card *card; 

struct list head list; 

struct list head card list; 
h 


添加 一 个 SOC platform: 


int snd soc add platform(struct device *dev, struct snd soc platform *platform, 
const struct snd soc platform driver *platform drv) 


所 有 的 snd soc. codec 将 被 添加 到 codec 链表 中 : 


static LIST HEAD(platform list); 


15.3.5 PCM 运行 时 配置 


snd soc card 有 一 个 rtd list 成 员 ， 用 来 保存 snd soc pcm runtime 结构 ， 该 结构 
卡 运行 时 配置 。 


struct snd soc pcm runtime { 
struct device *dev; 
struct snd soc card *card; 
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struct snd soc dai link *dai link; 

struct mutex pcm mutex; 

enum snd soc pcm subclass pcm subclass; 
struct snd pcm ops ops; 

unsigned int dev registered:1; 

/*3ljds PCM BE 运行 时 数据 */ 

struct snd soc dpcm runtime dpcm[2]; 

intfe compr; 

long pmdown time; 

unsigned char pop wait:1; 

PSTTIB ACC 

struct snd pcm *pcm; 

struct snd compr *compr; 

struct snd soc codec *codec; 

struct snd soc platform *platform; 

struct snd soc dai *codec dai;// codec 端的 DAI 
struct snd soc dai *cpu dai;//CPU 端的 DAI 
struct snd soc component *component; 

struct snd soc dai **codec dais; 

unsigned int num codecs; 

struct delayed work delayed work; 

unsigned int num; /*JÀ 0 开始 的 单调 增 的 号 */ 
struct list head list; /*soc 声卡 的 rtd 链表 */ 


h 
soc bind dai link 函数 将 SOC 声卡 与 DAI 绑 定 ， 并 将 信息 保存 在 snd soc pem runtime 
结构 中 : 


static int soc bind dai link(struct snd soc card *card,struct snd soc dai link *dai link) 
1 
struct snd soc pcm runtime *rtd; 
struct snd soc dai link component *codecs = dai link-»codecs; 
struct snd soc dai link component cpu dai component; 
struct snd soc dai **codec dais; 
struct snd soc platform *platform; 
const char *platform name; 
int i; 
dev dbg(card-^»dev, "ASoC: binding %s\n", dai link-^name); 
rtd = soc new pcm runtime(card, dai link); 
if (!rtd)retum -ENOMEM; 
if (soc is dai link bound(card, dai link)) { 
dev dbg(card-^dev, "ASoC: dai link %s already bound", 
dai link->name); 
return 0; 
} 
cpu dai component.name = dai link-^cpu name; 


cpu dai component.of node = dai link-^cpu of node; 
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cpu dai component.dai name = dai link-^cpu dai name; 
rtd-^cpu dai = snd soc find dai(&cpu dai component); 
if (!rtd-^cpu dai) { 
dev err(card->dev, "ASoC: CPU DAI %s not registered n", 
dai link-^cpu dai name); 
goto err defer; 
} 
rtd->num codecs = dai link->num codecs; 
此 从 注册 的 CODEC 中 寻找 对 应 的 CODEC*/ 
codec dais= trtd->codec dais; 
for(i=0;1<rtd->num codecs; i++) { 
codec dais[i] = snd soc find dai(&codecs[i]); 
if (!codec dais[1]) { 
dev err(card->dev, "ASoC: CODEC DAI %s not registered n", 


codecs[i].dai name); 


goto err defer; 


j 
rtd->codec dai = codec dais[0]; 
rtd->codec = rtd->codec dai->codec; 
AURRA platform, VEE HY platform*/ 
platform name = dai link->platform name; 
if (!platform name && !dai link->platform of node) 
platform name = "snd-soc-dummy"; 
/* IEW plateform 中 寻找 对 应 的 plateform*/ 
list for each entry(platform, &platform list, list) { 
if(dai link-^platform of node) ( 
if (platform->dev->of node != 
dai link->platform of node) 


continue; 


} else ( 
if (stremp(platform-^component.name, platform name)) 
continue; 
} 
rtd->platform = platform; 
} 
if (!rtd->platform) { 
dev_err(card->dev, "ASoC: platform %s not registered\n", 
dai link->platform name); 
return -EPROBE DEFER; 
j 
soc add pcm runtime(card, rtd);// 将 rtd 添加 到 card 的 rtd 链表 中 
return 0; 


err defer: 


soc free pcm runtime(rtd); 


j 
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return -EPROBE DEFER; 


snd soc find dai 函数 从 component list 链表 中 寻找 对 应 的 DAT. 


15.3.6 DAPM 


DAPM (Dynamic Audio Power Management) 机 制 设计 的 目的 是 为 允许 便携 设备 在 音频 


子 系统 下 消耗 最 少 的 能 量 ， 它 独立 于 内 核 中 其 他 的 电源 管理 系统 ， 能 很 好 地 与 其 他 电源 管理 


系统 共存 。 另 外 ，kcontrol 接口 之 间 相 互 独立 ， 无 法 联动 ， 并 且 没 有 事件 处 理 接 口 。DAPM 
很 好 地 解决 了 这 个 问题 。DAPM 单元 (widget) 定义 如 下 ; 


struct snd soc dapm widget { 


enum snd soc dapm type id; 
const char *name;/* 本 单元 名 */ 


const char *sname;/* 流 名 */ 


struct list head list; 

struct snd soc dapm context *dapm; 

void *priv; ”/* 私 有 数据 */ 

struct regulator *regulator; /x* 绑 定 的 电源 调节 器 */ 

const struct snd soc pcm stream *params; /*dai links 参数 */ 
unsigned int num params; /*dai links 参数 个 数 */ 

unsigned int params select; /* 当 前 dai links. 参数 */ 

/*dapm 控制 */ 

int reg; /*negative reg — no direct dapm*/ 

unsigned char shift; /*$£4y*/ 

unsigned int mask; — /* JEF Az Bg n 

unsigned int on val; /* 打 开 状 态 的 值 */ 
unsigned int off val; /* 关 闭 状态 的 值 */ 
unsigned char power:1; 


unsigned char active:1; 

unsigned char connected:1; 

unsigned char new:1; 

unsigned char force:1; 

unsigned char ignore suspend:1; 

unsigned char new power:1; 

unsigned char power checked:1; 

unsigned char is_supply:1;* 是 否 供给 类 型 的 单元 */ 
unsigned char is ep:2; 上 # 是 否 端点 类 型 的 单元 装 
intsubseq; 。” 放 单 元 类 型 排序 */ 

int (*power check)(struct snd soc dapm widget *w); 
此 外 部 事件 */ 

unsigned short event flags; 放 事 件 类 型 */ 

int (*event)(struct snd soc dapm widget*, struct snd kcontrol *, int);// 事 件 处 理 
[*J&HXIT] kcontrol*/ 

int num kcontrols;// kcontrol 数量 


const struct Snd_kcontrol new *kcontrol news; 
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struct clk *clk; 
5 
DAPM widget 包含 如 下 类 型 : 


enum snd soc dapm type { 


snd soc dapm input = 0, /# 输 入 管 脚 %/ 

snd soc dapm output, /输出 管 脚 六 

snd soc dapm mux, JE 多 个 输入 live) 

snd soc dapm demux, PRIA ERIE Pins th HR 
snd soc dapm mixer, PREIS I 


/* [i] snd soc dapm mixer， 区 别 在 于 混 音 元 素 名 不 会 添加 混 音 单元 名 前 级 */ 


snd soc dapm mixer named ctl, 


snd soc dapm pga, /# 可 编程 增益 放大 /衰减 器 次 
snd soc dapm out drv, /输出 驱动 器 对 

snd soc dapm adc, /*AD 转换 */ 

snd soc dapm dac, /XDA 转换 */ 

snd soc dapm micbias, 放 麦 克 风 电源 偏 置 */ 

snd soc dapm mic, PEE vl AUS 

snd soc dapm hp, POSUERE EEBUS/ 

snd soc dapm spk, Pf n) 


je 
DAPM widget 之 间 可 以 相互 连接 ， 组 成 一 条 完整 的 音频 链 路 。 就 像 网 络 设 备 之 间 通 过 路 
器 相连 一 样 ，DAPM widget 也 通过 DAPM 路 由 连接 在 一 起 。DAPM widget 的 连接 关系 通 
过 snd soc dapm route 结构 描述 : 


struct snd soc dapm route { 
const char *sink;// H If] widget 
const char *control;//I f 44 
const char *source;//J) widget 


int (*connected)(struct snd soc dapm widget *source,struct snd soc dapm widget *sink); 
b 
如 果 snd soc dapm route 的 control 为 NULL， 则 表示 sink 与 source 直 连 在 一 起 。 一 个 
完整 的 音频 链 路 必须 有 一 个 有 效 的 终点 ， 例 如 : 
(D 从 DAC 到 输出 管 脚 。 
(2) 从 输入 管 脚 到 ADC。 
(3) 从 输入 管 脚 到 输出 管 脚 。 
(4) 从 DAC 到 ADC。 
内 核 在 下 列 情况 下 会 扫描 音频 链 路 (参见 dapm_ power widgets 函数 )， 并 给 音频 链 路 上 
的 DAPM widget 做 上 电 (power on) 与 下 电 (power off) 动作 : 
(1) UE 
(25 用 户 通 过 amixer 命令 等 方式 改变 音频 链 路 。 
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(3) 应 用 程序 打开 或 关闭 PCM 设备 。 
同 kcontrol 接口 一 样 ， 内 核定 义 了 一 系列 宏 来 组 装 DAPM widget: 


TEE 


#define SND SOC DAPM ADC(wname, stname, wreg, wshift, winvert) ^ 
í .d= snd soc dapm adc, .name = wname, .sname = stname, ^ 

SND SOC DAPM INIT REG VAL(wreg, wshift, winvert), } 
#define SND SOC DAPM DAC(wname, stname, wreg, wshift, winvert) \ 
s .d= snd soc dapm dac, ,name = wname, .sname = stname, ^ 

SND SOC DAPM INIT REG VAL(wreg, wshift, winvert) ) 
#define SND SOC DAPM MIXER(wname, wreg, wshift, winvert, V 

wcontrols, wncontrols)V 


{ .id= snd soc dapm mixer, .name = wname, V 
SND SOC DAPM INIT REG VAL(wreg, wshift, winvert), \ 


.kcontrol news = wcontrols, .num kcontrols = wncontrols; 


例如 WM9713 的 DAPM 接口 定义 如 下 : 


#define WM9713 HP MIXER CTRL(xname, xmixer, xshift) { \ 
.lface = SNDRV CTL ELEM IFACE MIXER, .name = xname, V 
info = snd soc info volsw, \ 


get = wm9713 hp mixer get, .put= wm9713 hp mixer put, V 
private value = SOC DOUBLE VALUE(SND SOC NOPM, \ 
xshift, xmixer, 1, 0, 0) V 
j 
static const struct snd kcontrol new wm9713 hpl mixer controls[] = 1 
WM9713 HP MIXER CTRL("Beep Playback Switch", HPL MIXER, 5), 
WM9713 HP MIXER CTRL('Voice Playback Switch", HPL MIXER, 4), 
WM9713 HP MIXER CTRL("Aux Playback Switch", HPL MIXER, 3), 
WM9713 HP MIXER CTRL("PCM Playback Switch", HPL MIXER, 2), 
WM9713 HP MIXER CTRL("MonolIn Playback Switch", HPL MIXER, 1), 
WM9713 HP MIXER CTRL("Bypass Playback Switch", HPL MIXER, 0), 


static const struct snd soc dapm widget wm9713 dapm widgets[] = { 
SND SOC DAPM MIXER("Left HP Mixer", AC97 EXTENDED MID, 3, 1, 
&wm9713 hpl mixer controlsOj ARRAY SIZE(wm9713 hpl mixer controls)), 
SND SOC DAPM DAC("Left DAC", "Left HiFi Playback", AC97 EXTENDED MID, 7, 1), 
SND SOC DAPM ADC('Left Voice ADC", "Left Voice Capture", SND SOC NOPM, 0, 0), 
SND SOC DAPM INPUT("PCBEEP"), 


s 


static const struct snd soc dapm route wm9713 audio map[]- { 
/*left HP mixer*/ 
{"Left HP Mixer", "Beep Playback Switch", "PCBEEP"|, 
{"Left HP Mixer", "Voice Playback Switch", "Voice DAC"}, 
{"Left HP Mixer", "Aux Playback Switch", "Aux DAC"), 
{"Left HP Mixer", "Bypass Playback Switch", "Left Line In"j, 
{"Left HP Mixer", "PCM Playback Switch", "Left DAC"), 
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{"Left HP Mixer", "MonoIn Playback Switch", "Mono In"), 
{"Left HP Mixer", NULL, "Capture Headphone Mux"}, 
j 


可 见 第 三 列 的 几 个 DAPM widget 通过 wm9713 audio map 中 间 列 的 开关 选择 一 个 连接 
到 名 为 Left HP Mixer 的 DAPM widget。 下 面 是 Left HP Mixer 的 连接 设置 实例 : 


[root@urbetter home |? ./amixer controls |grep 'Left HP Mixer' 
numid-82,iface-MIXER,name- Left HP Mixer Aux Playback Switch' 
numid-80,iface-MIXER,name- Left HP Mixer Beep Playback Switch' 
numid-85,iface-MIXER,name-'Left HP Mixer Bypass Playback Switch' 
numid-84,iface-MIXER,name-' Left HP Mixer MonoIn Playback Switch' 
numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 
numid-81 ,iface-MIXER,name-'Left HP Mixer Voice Playback Switch' 
/ 先 获取 一 下 该 控制 接口 的 信息 
[root@urbetter home]? ./amixer cget name-'Left HP Mixer PCM Playback Switch' 
numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 

; type-BOOLEAN,access-rw------ ,values-2 

: values-off,off 
[root(urbetter home]? — /amixer cset name-'Left HP Mixer PCM Playback Switch' 1 
numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 

; type-BOOLEAN,access-rw------ ,values-2 

: values-on,off 
[root@urbetter home]? — /amixer cset name-'Left HP Mixer PCM Playback Switch' 0 
numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 

; type-BOOLEAN,access-rw------ ,values-2 

: values—off,off 
/设置 参数 也 可 为 on 或 者 off 

[root(Qurbetter home]? ./amixer cset name='Left HP Mixer PCM Playback Switch' on 

numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 

; type-BOOLEAN,access-rw------ ,values-2 

: values-on,off 
[root(Qurbetter home]? — /amixer cset name-'Left HP Mixer PCM Playback Switch' off 
numid-83,iface-MIXER,name- Left HP Mixer PCM Playback Switch' 

; type-BOOLEAN,access-rw------ ,values-2 

: values—off,off 


执行 ./amixer cset name-'Left HP Mixer PCM Playback Switch' 1 表示 Left DAC 进入 音频 链 


Ik, Left HP Mixer 连接 到 Left DAC. 


~ 


15.4 ALSA 驱动 程序 实例 


本 节 介 绍 的 AC97 驱动 程序 由 S3C6410X 的 AC97 控制 单元 和 WM9714 编 解码 器 组 成 ， 
15-4 为 AC97 电路 原理 。 


X 
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AC97 BITCLK H BrTCLK 
AC97 SYNC 3 | ASYNC 
AC97 SDI z| SDATAIN WM9714 
AC97 SDO ii| SDATA OUT 
AC97 RSTn $ RESTB 
图 15-4 AC97 电路 原理 


15.4.4. S3C6410X 的 AC97 控制 单元 


S3C6410X 的 AC97 控制 站 


元 支持 AC97 2.0 版 本 的 特性 。AC97 控制 


单元 通过 AC-link 


(audio controller link) 总 


线 与 AC97 编 解 码 器 连接 。AC97 控制 


单元 向 AC97 编 解码 器 发 送 


PCM 数据 ，AC97 编 解码 器 的 DAC 转换 器 将 音频 采样 数据 转换 成 模拟 音频 
制 单元 还 接收 从 AC-link 上 传 过 来 的 PCM 音频 数据 。S3C6410X 的 AC97 控 
RE lE. 


HS. AC97 13 


* 制 单元 包括 以 下 


(1) 三 个 独立 通道 ， 分 别 用 于 立体 声 PCM 和 输入、 立体声 PCM 输出 和 单 声 道 MIC 输入 。 
(2) 支持 基于 DMA 的 操作 和 基于 中 晰 的 操作 。 
(3) 可 变 采 样 率 AC97 编 解码 接口 CASKHz 和 低 于 48kHz)。 
(4) 每 通道 16 个 FIFO。 
(50 只 文 持 基本 编 解码 器 。 
S3C6410X 的 AC97 控制 单元 的 接口 见 表 15-1。 
表 15-1 S3C6410X 的 AC97 控制 单元 
名 K 方向 说 明 
X97RESETn 输出 AC RESETn: 复位 
X97BITCLK 输入 AC BIT CLK: 12.288MHz 的 位 时 钟 
X97SYNC 输出 AC SYNC: 48kHz 的 帧 同步 
X97SDO 输出 AC SDO: 串 行 音频 数据 输出 
X97SDO 输入 AC SDO: 串 行 音频 数据 输入 
AC-link 是 一 种 全 双 工 、 固 定时 钟 的 数字 化 PCM 音频 流 。 它 采用 时 分 复 用 的 方式 来 处 理 


控制 寄存 器 的 访问 和 多 个 输出 输入 音频 流 。 


AC-link 将 每 个 音频 帧 分 为 12 个 输入 和 输出 数据 


流 。 每 个 流 的 分 } 辨 率 为 20bit。 每 个 音频 帧 包含 256bit 的 数据 ， 这 256bit 数据 分 成 13 个 时 间 
片 (Slot)。 第 0 个 时 间 片 为 16bit， 称 为 标签 片 ， 其 他 的 12 个 时 间 片 称 为 数据 片 ， 每 片 大 小 


为 20bit。 如 图 15-5 所 示 。 


Slot# 


SDATA_OUT 


图 15-5 AC-link 总 线 时 序 


CMD | CMD | PCM | PCM 
TAG | ADDR | para: | LEFT | RIGHT |RSRVD EI RSRVD|RSRVD|RSRVD | RSRVD |RSRVD |RSRVD 
STATUS|STATUS| PCM | PCM PCM 
SDATA IN opm BAD | LECT | Rican | SEND RSRVD|RSRVD|RSRVD | RSRVD |RSRVD |RSRVD 
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标签 片 包含 一 个 Ibit 的 有 效 帧 识别 位 和 12bit 的 有 效 数 据 片 的 位 置 识别 码 。 当 SYNC 为 
高 则 表示 一 个 数据 帧 开始 。SYNC 保持 高 的 时 间 与 标签 片 相 同 。AC97 帧 的 出 现 频率 为 
48kHz， 并 与 12.288MHz 的 位 时 钟 同步 BITCLK)。AC97 控制 单元 和 AC97 编 解 码 器 通过 
SYNC 和 BITCLK 来 决定 何 时 发 送 和 接收 音频 数据 。 发 送 端 在 BITCLK 的 上 升 沿 将 数据 放 到 
总 线 上 ， 而 接收 端 则 在 BITCLK 的 下 降 沿 进行 取样 。 发 送 端 负 责 填 写 标 签 片 中 的 有 效 数据 地 
址 。AC-link 的 数据 流 按照 MSB 到 LSB 的 顺序 排列 。 

AC-link 输出 帧 格式 (SDATA OUT) Jd 15-2. 


表 15-2 AC-link 输出 帧 格式 


Slot 号 说 明 
bit15=1, 则 当前 帧 包含 至 少 一 个 有 效 数据 片 
Slot0 bit14—bit3 对 应 于 12 个 数据 片 ， 为 0 则 对 应 的 数据 片 无 效 ， 为 1 则 对 应 的 数据 片 有 效 


bitO 和 bitl 为 编码 器 IO 比特 
bit19-0 则 为 写 AC97 编 解码 器 寄存 器 ，=1 则 为 读 AC97 编 解码 器 寄存 器 


pen bitl8—bitl2 为 AC97 编 解码 器 的 寄存 器 地 址 
Slot2 bit19 一 bit4 为 命令 数据 

Slot3 PCM 回放 左 声 道 数据 

Slot4 PCM 回放 右 声 道 数据 


15.4.2 Machine Driver 


WM9714 与 WM9713 的 功能 以 及 硬件 接口 相近 ， 可 以 采用 WM9713 驱动 。Machine 层 
驱动 代码 见 smdk wm9713.c。15.3.1 节 的 例子 也 来 自 该 文件 。 

snd soc dai link 定义 了 soc 平台 与 codec 之 间 的 关联 关系 。 例 如 SMDK 开发 板 中 的 
SOC 声卡 注册 代码 如 下 : 


static struct snd soc dai link smdk dai - ( 
.name = "AC97", 
.Stream name = "AC97 PCM", 
.platform name = "samsung-ac97", 
.cpu dai name = "samsung-ac97", 
.codec dai name = "wm9713-hifi", 


.codec name = "wm9713-codec", 
n 
static struct snd soc card smdk = 1 
.name = "SMDK WM9713", 
.owner = THIS MODULE, 
.dai link = &smdk dai, 
.num links = 1, 
je 
static struct platform device *smdk snd wm9713 device; 
static struct platform device *smdk snd ac97 device; 
static int init smdk init(void) 
{ 


int ret; 
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smdk snd wm9713 device = platform device alloc("wm9713-codec", -1); 
if (Ismdk snd wm9713 device)return -ENOMEM; 
ret = platform device add(smdk snd wm9713 device); /添加 " wm9713-codec" 平 台 设 备 
if (ret)goto errl; 
smdk snd ac97 device = platform device alloc(*soc-audio?", -1); 
if (Ismdk snd ac97 device) ( 
ret --ENOMEM; 
goto err2; 
} 
platform set drvdata(smdk snd ac97 device, &smdk); 
ret = platform device add(smdk snd ac97 _device);// 添 加 "soc-audio" 平 台 设 备 
if (ret)goto err3; 
return 0; 


15.4.3 Platform Driver 


Y 4 


SOC platform driver 主要 实现 了 CPU ùm DAI 驱动 ， 并 注册 SOC platform driver。 注 意 不 
要 与 驱动 模型 中 的 platform driver 混淆 。 代 人 码 在 sound/soc/amsung/ac97.c。 驱 动 入 口 如 下 : 


static struct platform driver s3c ac97 driver = ( 
.probe = s3c ac97 probe, 
remove = s3c ac97 remove, 
.driver = ( 
.name = *samsung-ac97", 
b 
5 


module platform driver(s3c ac97 driver); 
s3c6400 ac97 probe 函数 代码 如 下 : 


static int s3c ac97 probe(struct platform device *pdev) 
{ 
struct resource *mem res, *irq_res; 
struct sS3c audio pdata *ac97 pdata; 
int ret; 
ac97 pdata = pdev-»dev.platform data; 
if (lac97 pdata || lac97 pdata->cfg gpio) { 
dev_err(&pdev->dev“cfg gpio callback not provided! n"); 
return CEINVAL; 
j 
ARER B E 
irq res = platform get resource(pdev, IORESOURCE IRQ, 0); 
if (lirq res) { 
dev err(&pdev-»dev, *^AC97 IRQ not provided! n"); 
return CENXIO; 


403 


Linux 驱动 程序 开发 实例 第 2 版 


mem res = platform get resource(pdev, IORESOURCE MEM, 0); 
S3c ac97.regs = devm ioremap resource(&pdev-^dev, mem res); 
if(IS ERR(s3c ac97.regs)) 

return PTR ERR(s3c ac97.regs); 
//DMA 3x 
S3c ac97 pcm out.slave = ac97 pdata-^dma playback; 
S3c ac97 pcm out.dma addr = mem res->start + S3C AC97 PCM DATA; 
S3c ac97 pcm in.slave = ac97 pdata-^dma capture; 
S3c ac97 pcm in.dma addr = mem res->start + S3C AC97 PCM DATA; 
S3c ac97 mic in.slave = ac97 pdata-^dma capture mic; 
S3c ac97 mic in.dma addr = mem res->start + S3C AC97 MIC DATA; 
init completion(&s3c ac97.done); 
mutex init(&s3c ac97.lock); 
s3c ac97.ac97 clk = devm clk get(&pdev-»dev, “ac97”);// 获 取 时 钟 
if(IS ERR(s3c ac97.ac97 clk)) ( 

dev err(&pdev-»dev, “ac97 failed to get ac97 clock Wn"); 

ret --ENODEV; 

goto err2; 


} 

clk prepare enable(s3c ac97.ac97_clk);// 使 能 时 钟 

if (ac97 pdata->cfg gpio(pdev)) { 
dev_err(&pdev->dev, “Unable to configure gpio\n”); 
ret = -EINVAL; 
goto err3; 


} 
ret = request irq(irq res->start, s3c ac97 irq,0,“AC97”, NULL);/ 申 请 中 断 
if (ret < 0) { 

dev err(&pdev-»dev, “ac97: interrupt request failed.\n”); 


goto err4; 
j 
ret— snd soc set ac97 ops(&s3c ac97 ops);// 设 置 ac97 操作 函数 
if (ret != 0) ( 
dev err(&pdev-»dev, "Failed to set AC'97 ops: %d\n”, ret); 
goto err4; 
j 


ret = devm snd soc register component(&pdev-^dev, &s3c ac97 component, 
s3c ac97 dai, ARRAY SIZE(s3c ac97 daii));// 注 册 DAI 
if (ret)goto err5; 
ret = samsung asoc dma platform register(&pdev-^dev,ac97 pdata->dma filter);// 注 册 DMA 引擎 
if (ret) { 
dev err(&pdev-»dev, "failed to get register DMA: %d\n”, ret); 
goto err5; 


j 


return 0; 
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devm snd soc register component 函数 注册 了 CPU 端的 DAI 驱动 : 


static struct snd soc dai driver s3c ac97 daill={ 
[S3C AC97 DAI PCM]- { 

.name = ” amsung-ac97", 

.bus control = true, 

.playback = { 
.stream_name = “AC97 Playback", 
.channels_min =2, 
.channels_max =2, 
rates = SNDRV PCM RATE 8000 48000, 


.formats = SNDRV PCM FMTBIT S16 LE,}, 
capture = ( 


.Stream name = *AC97 Capture", 
channels min = 2, 
.channels max = 2, 
rates - SNDRV PCM RATE 8000 48000, 
.formats = SNDRV PCM FMTBIT S16 LE,}, 
.probe = s3c ac97 dai probe, 
.ops = &s3c ac97 dai ops, 


h 
s3c ac97 dai probe 函数 主要 初始 化 DMA 参数 。 


static struct s3c dma params s3c ac97 pcm out = ( 
.dma size — —4, 

je 

static struct s3c dma params s3c ac97 pcm in- { 
.dma size — —4, 


h 

static int s3c ac97 dai probe(struct snd soc dai *dai) 

1 
samsung asoc init dma data(dai, &s3c ac97 pem out, &s3c ac97 pcm in);// 初 始 化 DMA 参数 
return 0; 

j 


samsung asoc dma platform register 函数 注册 了 一 个 基于 PCM 的 DMA 引擎 : 


int samsung asoc dma platform register(struct device *dev,dma filter fn filter) 


1 
samsung dmaengine pcm config.compat filter fn = filter; 
return deym snd dmaengine pcm register(dev, 
&samsung dmaengine pcm config, 
SND DMAENGINE PCM FLAG CUSTOM CHANNEL NAME | 
SND DMAENGINE PCM FLAG COMPAT); 
j 


int snd dmaengine pcm register(struct device *dev, 
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const struct snd dmaengine pcm config *config, unsigned int flags) 


struct dmaengine pcm *pcm; 

int ret; 

pem = kzalloc(sizeof(*pcm), GFP KERNEL); 

if ('pem)return -ENOMEM; 

pcm-»config = config; 

pcm->flags = flags; 

ret = dmaengine pcm request chan of(pcm, dev, config); 


if (ret)goto err free dma; 
ret = snd soc add platform(dev, &pcm-»platform,&dmaengine pcm platform); 
if (ret)goto err free dma; 
return 0; 
err free dma: 
dmaengine pcm release chan(pecm); 
kfree(pem); 
return ret; 


} 
而 基于 DMA 的 SOC platform 的 驱动 在 SOC 层 实现 : 


static const struct snd pcm ops dmaengine pcm ops- ( 


.Open = dmaengine pcm open, 

.close = snd dmaengine pcm close, 
ioctl —snd pem lib ioctl, 

.hw params = dmaengine pcm hw params, 
.hw free = snd pcm lib free pages, 
trigger —snd dmaengine pcm trigger, 
.pointer — dmaengine pcm pointer, 


h 
static const struct snd soc platform driver dmaengine pcm platform = ( 
.component driver = ( 
.probe order - SND SOC COMP ORDER LATE, 


j ^5 
.OpS = &dmaengine pcm ops, 
.pcm new = dmaengine pcm new, 


h 
s3c ac97 dai probe 函数 还 修改 了 AC97 总 线 的 操作 函数 : 


static struct snd ac97 bus ops s3c ac97 ops- ( 


read = s3c ac97 read, 
.Write — s3c ac97 write, 
.warm reset = s3c ac97 warm reset, 
reset = s3c ac97 cold reset, 
h 
ret = snd soc set ac97 ops(&s3c ac97 ops); 
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AC97 寄存 器 读 操作 函数 如 下 : 


static unsigned short s3c ac97 read(struct snd ac97 *ac97,unsigned short reg) 
1 
u32 ac glbctrl,ac codec cmd; 
u32 stat, addr, data; 
mutex lock(&s3c ac97.lock); 
S3c ac97 activate(ac97); 
reinit completion(&s3c ac97.done); 
ac codec cmd = readl(s3c ac97.regs + S3C AC97 CODEC CMD); 
ac codec cmd = S3C AC97 CODEC CMD READ|AC CMD ADDR(reg); 
writel(ac codec cmd, s3c ac97.regs + S3C AC97 CODEC CMD); 
udelay(50); 
ac glbctrl = readl(s3c ac97.regs + S3C AC97 GLBCTRL); 
ac glbctrl|- S3C AC97 GLBCTRL CODECREADYIE; 
writel(ac glbctrl, sS3c ac97.regs + S3C AC97 GLBCTRL); 
if(!wait for completion timeout(&s3c ac97.done, HZ)) 
pr err(^AC97: Unable to read!”); 
stat = readl(s3c ac97.regs + S3C AC97 STAT); 
addr = (stat >> 16) & 0x7f; 
data = (stat & Oxffff); 
if (addr != reg) 
pr err(^ac97: req addr = 9602x, rep addr = %02x\n”, 
reg, addr); 
mutex unlock(&s3c ac97.lock); 
return (unsigned short)data; 


} 
AC97 寄存 器 写 操作 函数 如 下 : 


static void s3c ac97 write(struct snd ac97 *ac97, unsigned short reg,unsigned short val) 
1 
u32 ac glbctrl,ac codec cmd; 
mutex lock(&s3c ac97.lock); 
S3c ac97 activate(ac97); 
reinit completion(&s3c ac97.done); 
ac codec cmd = readl(s3c ac97.regs + S3C AC97 CODEC CMD); 
ac codec cmd - AC CMD ADDR(reg) | AC CMD DATA(val); 
writel(ac codec cmd, s3c ac97.regs + S3C AC97 CODEC CMD); 
udelay(50); 
ac glbctrl = readl(s3c ac97.regs + S3C AC97 GLBCTRL); 
ac glbctrl|- S3C AC97 GLBCTRL CODECREADYIE; 
writel(ac glbctrl, sS3c ac97.regs + S3C AC97 GLBCTRL); 
if(!wait for completion timeout(&s3c ac97.done, HZ)) 
pr err(^AC97: Unable to write!"); 
ac codec cmd = readl(s3c ac97.regs + S3C AC97 CODEC CMD); 
ac codec cmd |= S3C AC97 CODEC CMD READ; 
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writel(ac codec cmd, s3c ac97.regs + SAC AC97 CODEC CMD); 
mutex unlock(&s3c ac97.lock); 


15.4.4 Codec Driver 
codec 层 代 人 码 在 wm9713.c 文件 中 。 驱 动 代码 入 口 如 下 : 


static struct platform driver wm9713 codec driver = ( 
.driver = ( 
.name = ^wm9713-codec", 
jc 
.probe = wm9713 probe, 
remove = wm9713 remove, 
je 


module platform driver(wm9713 codec driver); 


wm9713-codec 平台 设备 已 在 machine JAX. wm9713. probe 函数 注册 了 codec 与 DAI 


IK, AARIA T: 
static struct snd soc codec driver soc codec dev wm9713 = { 
.probe = wm9713 soc probe, 
.Temove= X wm9713 soc remove, 
.Suspend=  wm9713 soc suspend, 
resume - | wm9713 soc resume, 


.set bias level = wm9713 set bias level, 

.controls = wm9713 snd ac97 controls,// 控 制 接口 
.num controls = ARRAY SIZE(wm9713 snd ac97 controls), 
.dapm widgets = wm9713 dapm widgets//DAMP 单元 

.num dapm widgets= ARRAY SIZE(wm9713 dapm widgets), 
.dapm routes = wm9713 audio map, //DAMP 路 
.num dapm routes = ARRAY SIZE(wm9713 audio map), 


h 
static struct snd soc dai driver wm9713 daill={ 


1 


ZI 


.name = "wm9713-hifi", 
.playback = 1 
.Stream name = "HiFi Playback", 
channels min = 1, 
.channels max = 2, 
rates - WM9713 RATES, 
formats = SND SOC STD AC97 FMTS,j, 
capture = { 


.stream name = "HiFi Capture", 
.channels min = 1, 
.channels_max =2, 

rates = WM9713 RATES, 
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.formats = SND SOC STD AC97 FMTS,}, 
.ops = &wm9713 dai ops hifi, 
} , 


h 
static int wm9713 probe(struct platform device *pdev) 
1 
struct wm9713 priv *wm9713; 
wm9713 = deym kzalloc(&pdev-^dev, sizeof(*wm9713), GFP KERNEL); 
if (wm9713 — NULL) 
return -ENOMEM; 
mutex_init(&wm9713->lock);// 初 始 化 互 斥 锁 
platform set_drvdata(pdev, wm9713); 
return snd soc register codec(&pdev-»dev, 
&soc codec dev wm9713, wm9713 dai, ARRAY SIZE(wm9713 dai)); 


) 
wm9713 soc probe 函数 创建 了 一 个 AC97 声卡 实例 ， 并 对 该 声卡 进行 了 寄存 器 映射 ， 
为 后 面 的 声卡 控制 打下 基础 。 


static int wm9713 soc probe(struct snd soc codec *codec) 
1 
struct wm9713 priv *wm9713 — snd soc codec get drvdata(codec); 
struct regmap *regmap; 
/创建 AC97 声卡 
wm9713->ac97 = snd soc new ac97 codec(codec, WM9713 VENDOR ID, 
WM9713 VENDOR ID MASK); 
if(IS ERR(wm9713-»ac97)) 
return PTR ERR(wm9713-»ac97); 
regmap —regmap init ac97(wm9713-»ac97, &wm9713 regmap config)//AC97 声卡 的 寄存 器 映射 
if(IS ERR(regmap)) 1 
snd soc free ac97 codec(wm9713-»ac97); 
return PTR. ERR(regmap); 


j 

snd soc codec init regmap(codec, regmap);/ 初 始 化 SOC codec 的 寄存 器 映射 
snd soc update bits(codec, AC97 CD, 0x7fff, 0x0000);/ 取 消 静音 

return 0; 


j 
他 代码 读者 可 以 到 内 核 代 码 中 阅读 。 


15.5 ALSA 音频 缓冲 逻辑 


snd pem runtime 结构 几乎 包含 了 音频 缓冲 多 和 辑 所 有 的 信息 : 


struct snd pcm runtime ( 
让- 状态 --*/ 
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snd pcm uframes tavail max; 

snd pcm uframes thw ptr base; /"fHCTEXEHUHEBRUE*/ 
snd pcm uframes thw ptr interrupt; 入 中断 时 的 便 件 指针 次 
unsigned long hw ptr jiffies; /*hw_ptr 更 新 的 时 间 */ 
unsigned long hw. ptr buffer jiffies; /* 绥 冲 对 应 的 时 间 ， 根 据 采 样 率 计算 ， 单 位 为 jiffies*/ 
/*-- 硬件 参数 -六 
snd pcm uframes t period size; PTET BRA 7] v7 


unsigned int periods; [rpm] Ba cw 
snd pcm uframes t buffer size; 此 环形 缓冲 大 小 */ 
snd pcm_uframes t min align; PR! OSEE 


size tbyte align;/ 字 节 对 齐 

unsigned int frame bits; 

unsigned int sample bits; 

unsigned int info; 

Pr-- 软件 参数 --*/ 

unsigned int period. step; 

snd pem uframes t start threshold;///r12/] E] (Ei 
snd pcm uframes tstop threshold;//f; 1E [3] fH 
snd pcm uframes tsilence threshold; /* 当 噪声 超过 此 值 开始 填充 静音 */ 
snd pcm uframes tsilence size; ”填充 静音 的 大 小 */ 


snd pcm uframes t boundary; Tata El*/ 
snd pcm uframes t silence start; /* Hf Pr KFR £L */ 


snd pcm uframes tsilence filled; /* 已 填充 静音 的 大 小 */ 
[*-- 映射 --*/ 

struct snd pcm mmap status *status; 

struct snd pcm mmap control *control; 

/*-- 硬件 描述 --*/ 


struct snd pcm hardware hw; 


struct snd pcm hw constraints hw constraints; 

/*-- DMA --*/ 

unsigned char *dma area; —/*DMA 区 虚拟 地 址 */ 
dma addr tdma add; —— /*DMA 区 物理 地 址 */ 
size t dma bytes; /*DMA 区 大 小 */ 
struct snd dma buffer *dma buffer p; * e BOR np 


B 
snd_pcm uframes t (无 符号 类 型 ) 与 snd pem sframes t (有 符号 类 型 ) 为 内 核 中 音频 
帧 的 单位 。snd_pcm_substream 结构 的 runtime 成 员 用 于 记录 缓冲 的 运行 状态 。 内 核 环形 缓冲 
实际 大 小 为 runtime-> buffer size( 音 频 帧 )， 基 地 址 为 runtime-> dma area。 应 用 层 读 写 指针 为 
runtime->control->appl_ptr， 人 硬件 读 写 指针 为 runtime->status->hw_ptr。 为 了 计算 方便 ， 内 核 
将 这 个 缓冲 虚拟 成 runtime-> boundary 大 小 : 


runtime->boundary = runtime->buffer size; 
while (runtime->boundary * 2 <= LONG MAX - runtime->buffer size) 
runtime->boundary *= 2; 


runtime->control->appl_ptr 的 范围 从 0 到 runtime-> boundary， 但 实际 写 数据 时 的 地 址 会 
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映射 到 runtime-> dma area 开始 的 区 域 : 
appl ofs = appl ptr % runtime->buffer size; 


ALSA 环形 缓冲 逻辑 如 图 15-6 所 示 。 


runtime->hw_ptr_base 为 硬件 
虽 针 基地 址 ， 初 始 为 0 runtime-»Period size 
可 设置 ，256/512 帧 


runtime->control->appl_ptr 


Runtime->status->hw_ptr runtime->boundary 
snd pcm update hw ptrO 


映射 到 第 一 区 ，runtime->dma_addr + 
prtd->period * period size; 
runtime-»dma area 传输 完成 后 更 新 指针 


prtd-»params-dma addr 
图 15-6 ALSA 音频 缓冲 逻辑 

应 用 层 调 用 Alsalib 的 snd_pcm_writei 函数 写 音 频数 据 ，snd_pcm_writei 函数 通过 IOCTL 
命令 (SNDRV PCM IOCTL WRITEI FRAMES) 向 内 核 写 入 音频 数据 ， 该 命令 会 调用 内 核 
的 snd pem lib writel 函数 ， 而 snd pem lib writel 函数 会 根据 runtime->control->appl ptr 找 
到 当前 应 用 指针 ， 复 制 应 用 层 的 数据 到 内 核 后 更 新 runtime->control->appl_ptr: 


snd pcm sframes tsnd pcm lib writel(struct snd pcm substream *substream, 
unsigned long data,esnd pcm uframes t size,int nonblock,transfer f transfer) 


avail = snd pcm playback avail(runtime); 

while (size > 0) { 
snd pcm uframes t frames, appl ptr, appl ofs; 
snd pcm uframes t cont; 


frames = size > avail ? avail : size; 
cont = runtime-»buffer size - runtime-^control-^appl ptr % runtime-^buffer size; 
if (frames > cont) 
frames = cont; 
if(snd BUG ON(!frames)) ( 
runtime-^twake = 0; 
snd pcm stream unlock irq(substream); 
return -EINVAL; 


j 
appl ptr = runtime-^control-^appl ptr; 
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appl ofs = appl ptr % runtime->buffer size; 
snd pcm stream unlock irq(substream); 


err — transfer(substream, appl ofs, data, offset, frames); 
snd pcm stream lock irq(substream); 
if (err « 0) 

goto end unlock; 


appl ptr += frames; 

if (appl ptr >= runtime-^boundary) 
appl ptr -= runtime-^boundary; 

runtime-^control-^appl ptr = appl ptr; 

if (substream->ops->ack) 
substream-^ops-^ack(substream); 

offset += frames; 

size -= frames; 

xfer += frames; 

avail -= frames; 


} 


DMA 控制 器 每 次 传输 runtime->period size 个 音频 帧 ， 传 输 完 毕 会 调用 snd pem update - 
hw_ptr0 函数 更 新 硬件 指针 ， 并 进行 下 一 次 runtime->period size 个 音频 帧 的 传输 ， 周 而 复 始 。 


static int snd pcm update hw ptrO(struct snd pcm substream *substream,unsigned int in interrupt) 


1 
runtime-^hw ptr base = hw base; 
runtime-^status-^hw ptr- new hw ptr; 
runtime-^hw ptr jiffies = curr jiffies; 

j 


snd pem playback hw avail 函数 返回 已 经 到 达 的 音频 数据 : 


snd pcm sframes tsnd pcm playback hw avail(struct snd pcm runtime *runtime) 


1 
return runtime-^buffer size - snd pcm playback avail(runtime); 
} 
snd pem playback avail 函数 返回 剩余 音频 缓冲 : 


static inline snd pcm uframes tsnd pcm playback avail(struct snd pcm runtime *runtime) 


1 


snd pcm sframes t avail = runtime-^status-^hw ptr  runtime-^buffer size - runtime-^control-^appl ptr; 
if (avail < 0) 

avail += runtime-»boundary; 
else if ((snd pcm uframes t) avail >= runtime-^boundary) 

avail -= runtime-^boundary; 
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return avail 
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A 


$153 
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runtime-> start threshold 是 声卡 处 于 准备 状态 时 局 动 音频 播放 的 组 
数据 量 大 于 这 个 阐 值 ， 则 启动 播放 。 


snd pcm sframes t snd pcm lib writel(struct snd pcm substream *substream, 


' 闵 值 ， 内 核 缓冲 的 


unsigned long data,snd pcm uframes t size,int nonblock,transfer f transfer) 


{ 


if (runtime->status->state == SNDRV PCM STATE PREPARED && 
snd pcm playback hw avail(runtime) >= (snd pcm sframes t)runtime-^start threshold) { 


err = snd pem start(substream); 
if (err « 0) 
goto end unlock; 


15.6 ALSA 应 用 编程 接口 


在 应 用 层 ，ALSA 音频 设备 上 


EIN 


“plughw:x,y” 表 示 ， 如 “hw:0,0” 表 示 第 一 个 声卡 上 第 


个 ALSA 音频 设备 。 如 果 是 播放 ， 则 ALSA 自动 将 设备 名 转化 为 pemCxDyp， 如 果 是 录音 则 


转化 为 pcmCxDyc。 


在 介绍 ALSAAPI 函数 之 前 ， 先 来 了 解 两 个 概念 : 


(1) 交织 与 非 交织 
交织 音频 数据 是 指 


左右 两 个 声 道 ， 假 如 L~ 表示 左 声 道 数 据 ，R1 一 Rm 表示 


织 音频 流 数据 格式 如 下 


音频 


L1 R1 L2 R2 L3 R3 L4 R4 L5 R5 L6 R6 L7 R7 L8 R8 L9 R9*-: Lr Rn 


左 声 道 数据 ， 后 放 右 声 道 数 据 。 周 期 的 单位 为 
T. 


交织 音频 流 数据 格式 如 


音频 按照 周期 (period) 来 存储 与 处 理 。 
非 交 织 音频 数据 指 一 个 周期 内 ， 音 频数 据 按照 声 道 来 存放 ， 例 如 在 双 声 道 情况 下 ， 先 放 
普 频 帧 。 假 设 周期 为 n Wi, 16-bit 双 声 道 的 非 


L1 L2 L3 LA L5 L6 L7 L8 L9:-:Ln R1 R2 R3 R4 R5 R6 R7 R8 R9: Rz 


(25 数据 传送 模式 


ALSA 文 持 两 种 数据 传送 模式 : 


2) 内 存 映射 模式 : 


音频 数据 按 帧 存放 ， 每 帧 包含 所 有 声 道 的 音频 数据 。 双 声 道 音频 包 
声 道 数据 ，16-bit 双 声 道 的 


n» 


和 


N 
7i 


读 写 函数 如 snd pem write 和 snd pcm read 操作 数据 。 


直接 将 数据 写 到 一 个 映射 后 的 内 存 地 址 。 


下 面 介 绍 ALSA API 函数 。 
PCM 硬件 设备 参数 结构 (snd pem hw params t) 的 设置 和 初始 化 的 函数 有 : 
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/分 配 一 个 参数 结构 

int snd pcm hw params malloc (snd pcm hw params t **ptr); 
/初始 化 硬件 参数 结构 

int snd pcm hw params any (snd pcm t *pcm, snd pcm hw params t *params) 
/释放 一 个 参数 结构 的 内 存 

void snd pem hw params free (snd pcm hw params t *obj) 

/设置 数据 传送 模式 


int snd pcm hw params set access ( Snd pcm t *pcm, 


snd pcm hw params t *params, snd pcm access t access) 
数据 传送 模式 (snd pem access fb 包括 四 种 : 
€ SND PCM ACCESS MMAP INTERLEAVED: 内 存 映 射 和 交织 
€ SND PCM ACCESS MMAP NONINTERLEAVED: 内 存 映 射 和 非 交 织 


€ SND PCM ACCESS RW NONINTERLEAVED: 常规 模式 和 非 交 织 


snd pcm hw params set format 用 来 设置 数据 格式 ， 主 要 控制 输入 的 音频 数据 的 类 型 、 
无 符号 还 是 有 符号 、 是 little-endian 还 是 big-endian。 


int snd pcm hw params set format(snd pcm t *pcm, 


snd pcm hw params t *params, 
snd pcm format t val); 


Enni 


snd pcm hw params set channels 设置 音频 设备 的 声 道 ， 常 见 的 就 是 单 声 道 和 立体 声 
如 果 是 立体 声 ， 最 后 一 个 参数 val 为 2。 


E 


int snd pcm hw params set channels(snd pcm t *pcm, 


snd pcm hw params t *params, 
unsigned int val); 


T 
N 


snd pcm hw params set rate near 设置 音频 数据 的 最 接近 有 目标 的 采样 


sz 
X 
o 


int snd pcm hw params set rate near(snd pcm t *pcm, 


snd pcm hw params t *params, 
unsigned int *val, int *dir); 


snd pcm open 函数 打开 PCM 设备 : 


int snd pcm open (snd pcm t **pcm, const char *name, snd pcm stream t stream, int mode); 


snd pcm hw params 函数 用 来 设置 PCM 音频 设备 的 参数 : 


int snd pcm hw params (snd pcm t *pcm, snd pcm hw params t *params); 


PCM 音频 设备 的 读 写 接口 函数 如 下 : 


/准备 好 PCM 设备 ， 以 便 写 入 PCM 数据 

int snd pcm prepare (snd pcm t *pcm); 

/把 交织 音频 数据 写 入 到 音频 设备 

snd pcm sframes t snd pcm writei (snd pcm t *pcm, const void *buffer, snd pcm uframes t size); 
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/把 非 交 织 音频 数据 写 入 到 音频 设备 
snd pcm sframes t snd pcm writen (Snd pcm t *pcm, const void *buffer, snd pcm uframes t size); 


// 从 音频 设备 读 取 交织 音频 数据 


snd pcm sframes t snd pcm readi (snd pcm t *pcm, const void *buffer, snd pcm uframes t size); 


/从 音频 设备 读 取 非 交织 音频 数据 


snd pcm sframes t snd pcm readn(snd pcm t *pcm, const void *buffer, snd pcm uframes t size); 


snd pom close 函数 关闭 PCM 设备 : 
int snd pcm close (snd pcm t *pcm); 


Alsalib 库 设备 打开 函数 为 snd pcm_open， 打 开设 备 后 可 以 对 设备 设置 参数 ， 最 后 读 写 数 


据 。 所 有 参数 先 存放 到 sad pom hw params t 结构 中 ， 设 置 好 snd pem hw params t 结构 后 ， 
将 参数 整体 写 入 设备 驱动 。 参 数 设置 完毕 就 可 以 调用 snd pem writei 和 snd pem readi 进行 音 


频数 据 读 写 了 。 


例 1$.1 基本 的 ALSA 音频 回环 实例 
代码 见 \samples\15alsa\15-1loop。 音 频 初 始 化 代码 如 下 : 


int set hw parameter(snd pcm t *audio handle) 


1 


int err; 
snd pcm hw params t *hw params; 


if((err = snd pem hw params malloc (&hw params)) < 0) { 
fprintf (stderr, "cannot allocate hardware parameter structure (Vos)Wn", 
snd strerror (err)); 
return err; 
} 
if ((err = snd pem hw params any (audio handle, hw params)) < 0) { 
fprintf (stderr, "cannot initialize hardware parameter structure (%s)\n", 
snd strerror (err)); 
return err; 
} 
if ((err = snd pcm hw params set access (audio handle, 
hw params, SND PCM ACCESS RW INTERLEAVED)) « 0) { 
fprintf (stderr, "cannot set access type (%s)\n", 


snd strerror (err)); 
return err; 
j 
if ((err = snd pem hw params set format (audio handle, 
hw params, SND PCM FORMAT S16 LE)) « 0) ( 
fprintf (stderr, "cannot set sample format (Vos)n", 


snd strerror (err)); 
return err; 


j 


if ((err = snd pcm hw params set rate near(audio handle, hw params, &pcmrate, 0)) « 0) { 


fprintf (stderr, "cannot set sample rate (%s)\n", 
snd strerror (err)); 
return err; 


j 


if ((err = snd pem hw params set channels (audio handle, hw params, 2)) < 0) 1 
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fprintf (stderr, "cannot set channel count (%s)\n", 
snd strerror (err)); 
return err; 
} 
if ((err = snd pcm hw params (audio handle, hw params)) < 0) { 
fprintf (stderr, "cannot set parameters (Vos)Wn", 
snd strerror (err)); 
return err; 


j 


snd pcm hw params free (hw params); 


j 
/打开 音频 回放 
int initAlsa playback() 


{ 
int err; 
if((err = snd pcm open (&playback handle, "plughw:0,1", 

SND PCM STREAM PLAYBACK, 0)) « 0) 
fprintf (stderr, "cannot open audio device %s (%s)\n", "plughw:0,1",snd. strerror (err); 
return err; 

} 
return set hw parameter(playback handle); 
} 


MARRARA 
int initAlsa_Record() 


vint 


1 
int err; 
if ((err = snd pcm open (&capture handle, "plughw:0,1", 
SND PCM STREAM CAPTURE, 0)) « 0) { 
fprintf (stderr, "cannot open audio device %s (Vos) n", "plughw:0,1",snd. strerror (err); 
return err; 
j 
return set hw parameter(capture handle); 
j 


主线 程 负责 音频 采集 ， 并 将 数据 送 给 播放 缓冲 。 代 码 如 下 : 


int main(void) 
1 
int i0; 
int err; 
short buf[10240]; 
init cycle buffer(); 
initAlsa. playback(); 
initAlsa Record(); 
pthread create(&id, NULL.(void *)playbackthread, NULL); 
if ((err = snd pcm prepare (capture handle)) < 0) { 
fprintf (stderr, "cannot prepare audio interface for use (Vos) n",snd strerror (err)); 
exit (1) ; 


j 
while C1) 
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{ 
if ((err = snd pcm readi (capture handle, buf, 256)) != 256) 
{ 
fprintf (stderr, "read from audio interface failed (Vos) %d\n",snd strerror (err),err); 
snd pcm prepare(capture handle); 
} 
if(err>0) 
{ 
pthread mutex lock(&fifo->lock); 
fifo put(buf,err*4); 
pthread mutex unlock(&fifo->lock); 
if(g count<100)g counttt; 
} 
} 


snd pcm close (playback handle); 
snd pcm close (capture handle); 
exit(0); 

} 


项 播放 线程 从 音频 缓冲 获取 数据 并 播放 ， 代 码 如 下 : 


void playbackthread(void) 
{ 
int err; 
char buf[1024]; 
unsigned int n; 
whbile(g_count<2);/ 缓 冲 一 定 的 音频 数据 
while (1) 
{ 


pthread mutex lock(&fifo->lock); 
n = fifo get(buf, sizeof(buf)); 
pthread mutex unlock(&fifo->lock); 
if(n>0) 
{ 
if ((err = snd pem writei (playback handle,buf, n/4)) != ( n/4)) 
{ 
fprintf (stderr, "write to audio interface failed (%s)\n",snd_strerror (err)); 
snd pcm close (playback handle); 
initAlsa playback(); 


usleep (1) ; 
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